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L INTRODUCTION 


1.1 Microdata™ SEQUEL’ Computer System 


The SEQUEL computer system is a generalized system for data base management. 
It is a complete system providing multiple users with the capability to 
instantly update and/or retrieve information stored in on-line data files. 


Users communicate via local or remote terminals with computer files that may be 
private, common, or security-controlled. Each user’s vocabulary can be 
individually tailored to meet specific applications. 


SEQUEL systems are built of field-proven Microdata computers and peripherals, 
using microprograms to provide you with unrivaled performance and reliability 
in the super-mini computer market. 


The SEQUEL computer system includes the powerful, yet simple to use, 
ENGLISH® retrieval language, DATA/BASIC™’ and PROC high level languages, the 
EDITOR processor, complete program development facilities and file maintenance 
tools, and a host of other user amenities. SEQUEL systems run in an on-line, 
multiuser environment with all system resources and data files efficiently 
managed by a microprogrammed virtual-memory operating system. 


SEQUEL has advantages from every angle: system capability, multiuser 
performance, file management languages, ease of programming, data structure, 
and architectural features. SEQUEL’s high performance and fast response time 
are made possible by extensive use of high-speed microprocessors which greatly 
reduce program execution time and system overhead. The entire SEQUEL computer 
system is unique -- one of a kind. 


Microprogrammed firmware contains: 


- Virtual memory manager 

- Multiuser operating system 

« Special data management instructions 
+ Input/output processors 


System software includes: 


- ENGLISH, DATA/BASIC, PROC, EDITOR and ASSEMBLY languages 

« Selectable/automatic report formatting 

+ Dynamic file/memory management 

« RUNOFF’ text processing 

+ SCREENPRO'™ Language -- an easy way to set up terminal displays 


The file structure provides: 


+ Variable length files/records/fields 

« Multivalues (and subvalues) in a field 
» Efficient storage utilization 

- Fast access to data items 

- Selectable degrees of data security 

» File size limited only by size of disc 
« Item size up to 32,267 bytes 
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1.2 The Flexible Family of Microdata Computer Systems 


The expandable Microdata family of high-performance data base management 
processors ranges from an economical system for first-time users with limited 


data processing requirements and/or experience, to the high capacity systems 
used by some of the largest companies in the United States. 


Besides superb performance, the entire Microdata computer line offers unmatched 
growth advantages. As your company grows, you can add Microdata equipment to 
meet its increased data processing needs without the costly replacement and 
conversion charges usually associated with updating computer facilities. All 
Microdata systems are both hardware- and software-compatible. Start with 
Microdata. Grow with Microdata. 


A basic SEQUEL system has: 

- Central processing unit (CPU and cabinet) 

- Diagnostic Maintenance Processor 

- Mass storage dise drive 

- Input/Output Processor 

- Magnetic tape drive 

- Asynchronous communications line controller 

. PRISM® 4 cathode ray tube (CRT) data terminal (up to 127) 

» System printer 
All Microdata systems operate in Microdata”s easy-to-use ENGLISH retrieval 
language, as well as the more advanced DATA/BASIC and PROC, and are fully 
compatible with REALITY data processing systems. 
Microdata”s most advanced microprocessing technology was used in the design of 
the SEQUEL system to enable greater load capacity and still faster data 
processing to handle more applications -- all without overloading the central 
processing unit or degrading the speed of terminal response. This advanced 
system”’s exceptional power and adaptability provides up to 127 separate users 


with fingertip access to voluminous business, technical, and scientific 
applications that use data base management techniques. 
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Complete business computer capabilities 

Microprogrammed virtual memory operating system 

Up to 127 users and one billion characters of file storage 
On-line file update/retrieval 

ENGLISH retrieval language 

Fast terminal response 

Multiple printer spooling 


Optional communications capabilities 

Special data management processors 

High-speed sort capability 

Small computer price 

Big computer performance 

Top to bottom computer/peripheral compatibility within the Microdata 
family 


Figure A. Microdata SEQUEL System Advantages 


Figure B. Typical Microdata SEQUEL System 
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1.3 SEQUEL Software 


Processors available on the SEQUEL computer system comprise the most extensive 
data base management software available on any minicomputer. Overviews of the 


processors and their typical uses follow. 


ENGLISH Language 


ENGLISH is a generalized data retrieval/report generator language. A typical 
ENGLISH inquiry consists of a relatively free-form sentence containing verbs, 
file-names, data selection criteria, and control modifiers. An easy-to-use, 
dictionary-based language that uses simplified prose statements, ENGLISH 
permits you to produce original reports rapidly and efficiently. 


ENGLISH applications are limitless because of the ease with which output can be 
accessed from user files. Since nonprogrammers can master the process quickly, 
ENGLISH is a valuable information management tool for many people in an 
organization, from sales personnel to top-level executives. Its major uses are 
report generation and inquiry/response applications. You may also use ENGLISH 
to produce output after file updates with DATA/BASIC or PROC software, as well 
as for printing one-of-a-kind reports without writing a program. 


SCREENPRO 


The SCREENPRO processor was developed to minimize the software gap between the 
establishment of data files and the creation of reports. No longer must you 
develop your own method of creating and processing screens to display text, 
inputs, validations and updates. 


Because SCREENPRO requires fewer program statements, it greatly simplifies 
program maintenance while increasing operator and programmer efficiency. Data 
throughput is accelerated. A screen can be designed, displayed, tested and 
changed without affecting the program. 


DATA/ BASIC 


BASIC (Beginners All-purpose Symbolic Instruction Code) is a_ simple, yet 
versatile, programming language suitable for expressing solutions to a wide 
range of problems. DATA/BASIC, an extension of Dartmouth BASIC, is especially 
easy for the beginning programmer to learn. 


DATA/BASIC is the primary method of updating user files on a SEQUEL system. 
Because of its flexibility, DATA/BASIC is used for a variety of business 
applications including accounts payable/receivable, general ledger, inventory 
control, payroll, sales forecasting/analysis, order processing, invoicing, 
claims processing, data entry, and other projects. 


With the addition of SCREENPRO, DATA/BASIC programs are even easier to write -- 


and run faster -- since screen handling and data validation can be removed from 
the program. 
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PROC 


The PROC processor enables you to prestore a complex sequence of operations 
which can then be evoked by a single word command. Any sequence of operations 
that can be executed from the terminal can be prestored in a PROC. Although 
PROC is similar to the Job Control Language (JCL) used in larger computer 
systems, it is less cryptic and has far greater capabilities including 
interactive (optionally formatted) terminal prompting, input validation, 
printer formatting, and file input/output. 


PROCs are typically used to create special user-defined functions by combining 
execution of DATA/BASIC programs, ENGLISH data retrieval operations, and PROC 
argument passing. 


TERMINAL INDEPENDENT PROCESS HANDLER 


The Terminal Independent Process Handler (TIPH) initiates a process on a port 
without an associated terminal, thus freeing the terminal for user interaction. 
Any terminal output (such as error messages, logon/off messages) will be placed 
in a spooler hold file. Although terminal input is not allowed, you may 
"stack" input in the command stream sent to the TIPH processor. This allows 


execution of a program which requires operator input and such input is known in 
advance. 


EDITOR 


The EDITOR permits on-line interactive modification of any item in the data 
base. Primarily, the EDITOR is used to create and/or modify DATA/BASIC or PROC 
programs. The EDITOR enters and updates text processed by RUNOFF. 
Particularly useful in word processing is the EDITOK’s global search and 
replace capabilities. Performing one-of-a-kind modifications to items in user 
files is another EDITOR function. 


RUNOFF 


RUNOFF is a text processing facility offering many special features. Your 
RUNOFF text is entered and modified with the EDITOR. RUNOFF numbers pages 
automatically and can print text headings and footnotes. 


Another RUNOFF feature is chapter and section numbering. New chapters and/or 
sections may be added to a document, and the subsequent updated publication, 
with changes and additions, will be completely renumbered automatically. You 
may instruct RUNOFF to assemble and print a table of contents and an index 
based on specified words and phrases. Any changes you make to the text will 
automatically be reflected in both the table of contents and index. 


RUNOFF also performs tabulations, centering, selective left/right 
justifications, underlining, and boldface printing. 
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1.4 How to Use the SEQUEL Manuals 


This manual is written in modular format with each pair of facing pages 


presenting a single topic. 


The approach taken in this and other SEQUEL manuals differs substantially from 
the typical reference manual format. Here, each pair of pages discusses an 
individual topic. Generally the left-hand page is devoted to text, while the 
right-hand page presents figures referred to by the text. A pair of titles, 
the first naming the chapter and the second naming the topic, are at the top of 
each text page. Immediately below these titles is a brief summary of the 
material covered in the topic. 


The advantage of this format will become readily apparent as you begin to use 
this manual. First of all, the figures referred to in the text are always 
conveniently in front of you at the point where the reference is made. 
Secondly, there is a psychological advantage knowing that when a topic is 
completed and the page is turned, you are done with one idea and are ready for 
another. 


Documentation for the SEQUEL system includes the following manuals: 


. SEQUEL Programmer’s Reference Manual 

. SEQUEL Assembly Language Programming Manual 
. SEQUEL System Operation Guide 

+ Microdata Operator”s Quick Guide 

. Microdata EDITOR Programming Manual 

. Microdata ENGLISH Programming Manual 

» Microdata DATA/BASIC Programming Manual 

» Microdata PROC Programming Manual 

. Microdata SCREENPRO Programming Manual 

. Microdata 5750 Terminal Operator’s Guide 

.» SEQUEL 2870PLUS Communications Executive Manual 
. SEQUEL HASP Communications Executive Manual 


In presenting general command formats and examples throughout this and other 
SEQUEL manuals, certain conventions apply. Conventions used in presenting 
general command formats are listed in Figure A, while conventions used in the 
examples are listed in Figure B. , 


Marginal change bars will be used in future manuals and supplements for the 


convenience of present SEQUEL users and will indicate significant additions or 
changes from prior SEQUEL publications. 
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Convention 


UPPER CASE 


lower case 


{ } 


item~list* 


Meaning 


Characters printed tn upper case are required and must appear 
exactly as shoun. 


Characters or words printed in lower case are parameters to be 
supplied by you (t.@., file-name, item-id, data, ete.). 


Braces surrounding a word and/or parameter indicates that the 
word and/or parameter te optional and may be ineluded or 


omitted at your optton. 


If an ellipses (t.e., three dots) follows the terminating 
brace, then the enclosed word or parameter may be omitted or 
repeated an arbitrary number of times. 


An astertsk following an item-list indicates that the ltst of 
ttem-tdse may be omitted if supplied by a previous SELECT, 
SSELECT, GET-LIST, or FORM-LIST statement. 


Figure A. Conventions Used in General Command Formats 


Convention 
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Meaning 
Shaded text represents your input. 
Standard text represents output printed by the system. 


Italicized text ts used for comments and notes which help 
explain or desertbe the example. 


Thts symbol represents a carriage return. 

This symbol represents a line feed. 

This symbol specifies that the following character is a control 
character generated by pressing the <CTRL> key while typtng the 


character. Also presa the <SHIFT> key if the character appeare 
on the upper half of a key top. 


This ts the ASCII underline character represented as 
backarrow (==) on some terminals. 


Figure B. Conventions Used in Examples 
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1.5 SEQUEL Computer System Overview 


SEQUEL is a complete system of computer hardware, software, and firmware, 
specifically oriented to implement cost-effective data base management. Data 
base management systems implemented in SEQUEL afford two major benefits: (1) 


accurate and timely information to significantly improve the decision-making 
process, and (2) substantially reduced clerical and administrative effort 
associated with the collection, storage, and dissemination of information. 


SEQUEL is a complete computer system combining both proprietary hardware and 
software to create an effective tool for on-line data base Management. Through 
the use of microprogramming, Microdata has implemented an on-line transaction 
processing system. Three major components of the system have been implemented 
directly in CPU firmware: 


. Virtual memory operating system 
. Software level architecture 
. Terminal input/output routines (terminal I/O controller) 


Virtual memory operating systems, long used in larger computer systems, have 
been impractical for minicomputers due to the large amount of main memory 
needed for the operating system itself. In SEQUEL, the virtual memory 
operating system has been directly implemented in firmware (i.e., high-speed 
read-only memory), which executes many times faster than a comparable system 
normally implemented in software. With the virtual memory manager directly 
implemented in read-only memory, only a small amount of main CPU memory is 
needed to run SEQUEL. 


Slightly over 6,000 bytes of main memory must be allocated for the operating 
system monitor. Everything else (system software and data) is transferred 
automatically into main memory from virtual memory (i.e., disc) by the virtual 
memory operating system in a demand-paged environment. The SEQUEL computer 
system is organized into 5l2-byte pages (frames) stored on the disc. Asa 
frame is needed for processing, the operating system automatically transfers 
that frame from the disc unit (virtual memory) to main memory; this concept is 
illustrated in Figure A. The virtual memory feature of SEQUEL allows you to 
have access to a programming area not constrained by a main memory, but rather 
can be as large as the entire available disc storage on the systen. 


The second feature implemented directly in SEQUEL firmware is the software 
level architecture of the machine itself. Through microprogramming, Microdata 
has implemented a machine architecture expressly designed and optimized for 
data base management. SEQUEL assembly language architecture has very powerful 
instructions expressly designed for character moves, searches, compares, and 
all supporting operations to manage variable length fields and records. In 
addition, this software architecture has a very large field-proven software 
base written for data base management. 


8 83-1109 


1 INTRODUCTION 


The addition of a Terminal Input/Output Controller comprises the third 
microprogrammed feature. Microprogrammed onto this controller are input/output 
routines designed to handle communications between terminals and the CPU. In 
all minicomputer on-line applications, one of the main problems is managing the 
I/O from on-line interactive terminals. As these terminals increase in number, 
the load on the CPU becomes overwhelming; consequently, terminal response time 
can degrade dramatically. To solve these problems, Microdata developed a 
microprogrammed controller to directly control communications from and to all 
on-line terminals connected to the SEQUEL computer system. This means that 
process execution need not be interrupted to handle a character coming from or 
going to a terminal. This controller handles all these transactions and only 
interrupts the software at the completion of a line of data. As a result, a 
large number of terminals may be connected to the Microdata SEQUEL system 
without degradation due to terminal I/0. 


MAIN MEMORY 


_ 
- ; VIRTUAL MEMORY 
| om 


Figure A. SEQUEL Demand-Paged Environment 
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1.6 SEQUEL File Organization 


SEQUEL files are organized in a hierarchical structure, with files at one level 
pointing to multiple files at a lower level. Four distinct file levels exist: 


System Dictionary (SYSTEM), User Master Dictionary (M/DICT), Dictionary (DICT) 
Level File and Data File. 


The hierarchial SEQUEL file structure is illustrated in Figure A. Each level 
is described briefly below. 


SYSTEM Dictionary (SYSTEM) 


The highest level file on each system is the System Dictionary. This file is 
used for system control; it contains pointers to each user’s Master Dictionary 
and to various system support files. 


User Master Dictionaries 


Master Dictionaries (M/DICTs) comprise the next level. Each user’s account has 
an M/DICT associated with it; the M/DICT defines all user vocabulary, all 
accessible file-names and attributes describing the structure of the 
information in lower level dictionaries. File-name pointers can reference any 
file or dictionary in the system, subject to security restrictions. 


Dictionary Level Files 
Dictionary Level Files describe the structure of data in associated data files. 


Data Files 


Data Files contain the actual data stored in variable-length format. In 
addition to the normal record/field data structure, a field (called an 
attribute) can contain multiple values, and a value, in turn, can consist of 
multiple subvalues. Thus, data may be stored in a three~dimensional 
variable-length format. 


Internal Dictionary/File Structure 


The term "file" in the SEQUEL system refers to a mechanism for maintaining a 
set of like items logically together. The data in a file is normally accessed 
via the dictionary associated with it. Since the dictionary itself is also a 
file, it contains items just as a data file does. The items in a dictionary 
serve to define lower level dictionaries or data files. Several types of items 
are used in dictionaries: 


° File definition items: define files 


. File synonym definition items: point to files 
: Attribute definition items: describe fields 
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M/DICT 


Dictionary 
level file 


Data file 


Figure A. SEQUEL Hierarchial File Structure 
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2.1 Virtual Memory Structure 


SEQUEL’s virtual memory structure allows disc space to be immediately available 
as main memorye The entire set of data associated with a SEQUEL system 
(including executable programs, process work space, and all system and user 


files) reside in the virtual memory. The monitor remains resident in main 
memory , 


Prior to understanding the data structures used in the SEQUEL system, you must 
have a general understanding of the virtual memory structure. The following 
brief overview of that structure should supply sufficient background 
information. 


The virtual memory consists of a set of 512-byte frames, each addressable by a 
positive integer called the  Frame-ID (FID). The virtual memory contains 
absolute, work, and file areas, as illustrated in Figure A. Frames move 
between disc and main memory as required by the system. 


ABS Area 


Starting with the first frame (FID=1) and continuing upward is the Absolute 
area (called ABS). In this area, a minimum of 1215 frames, but not more than 
4096 frames, must be reserved. Frames 0 through 399 and 1000-1279 of the ABS 
Area are reserved for current and future SEQUEL software. The remaining frames 
of this area (400 through 999) are available for user-written assembly language 
programs. 


Primary Work Space 


You interact with the SEQUEL system via a terminal attached to a communications 
port on the SEQUEL CPU. The ongoing dialogue with any port is called a 
process. (Additionally, certain processes not actually connected with a 
communications port may be specified at system generation time.) Uniquely 
associated with each process is a Primary Control Block (PCB) which is a 
one-frame block that defines the state of the process at any instant. Each PCB 
is followed by a 3l-frame work space used by the process. Thus, 32 frames are 
initially reserved for each defined process. 
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VIRTUAL SPACE 
Reserved for operating system 


Absolute area for user-prepared Executable Area 
assembly programs 


system ABS 


~+——— Primary Work Space 


—<—— Permanent Logon Work Space 


~«—- 32 Frames for Spooler 


File Area 


5U5427% 


*Actual FID’s depend on particular system configuration. 
(This can be obtained by the WHAT verb as described in that topic.) 


Figure A. Overview of Virtual Memory Structure 


83-1109 13 


2 DATA STRUCTURES 


2.2 Low Disc Space Area and File Area 


Beginning immediately after the primary work space is the low disc space area. 
This area is used primarily for additional process work space. After the low 


disc space, the remainder of the virtual memory (called the file area) is 
available for storage of data in files. If the main file area is full, the low 
disc space area is used for data storage. Figure A illustrates these areas. 


Low Disc Space 


During a file restore, a pool of frames (called low disc space area) is 
allocated for additional LOGON work space.e Low disc space consists of 381 
frames for each process (line) as specified by hardware. 


The LOGON processor attempts to obtain additional work space frames from low 
disc space; if no low disc space is available, the LOGON processor attempts to 
obtain additional work space from the high disc space. Additional work space 
assignment is detailed in Chapter 6. 


High Disc Space (File Area) 


Immediately following Low Disc Space is an area called High Disc Space. Most 
processors, such as SORT, spooler and file processors, attempt to get space 


from this area; if no high space is available, an attempt is made to obtain 
low space. 


The effect of this allocation schedule is to keep additional process work 
spaces close to each other and to the 32-frame primary work spaces they are 
linked to. Because these usually constitute the most active frames on the 
system, disc head movement is minimized and overall system throughput is 
increased. 


Frames which are not in use at a given time are maintained as a pool of 


available space. Management of available space is discussed in the following 
topic. 
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ABS area 


Primary work space 


Low dise space 


High dise space 


97439# 


* Actual FIDs depend on the particular system configuration 
and software release level. This example is based on 
a 127 MB system with 8 processes, 


Figure A, Location of Low Dise Space and File Areas 
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2.3 Available Space Area 


File area frames (from high and low dise space) which are not allocated to the 


files are maintained as a pool of available space. 


The SEQUEL system uses available space for two purposes: 1) for additional 
file space and 2) for Ponnorery work space used by such processors as the 
spooler, PROC, and ENGLISH. Available space may be either in a "linked" form 
or in a "contiguous" form. Contiguous available space, as the name implies, 
consists of blocks of contiguous frames (defined by Beattie and endin 

numbers) that can be taken out of the pool either singly or as a block. Linke 

available space can only be taken a frame at a time. Conversely, space may be 
released by processors to the linked available pool a frame at a time or to the 
contiguous pool as a block. 


The SEQUEL system maintains four tables of pointers that define the available 
space. Two tables define contiguous blocks of space, one for file space and 
the other for temporary work space. The other two tables define linked chains, 
one for file space and the other for temporary space. 


Additional File Space 


The table defining contiguous file space may have up to 32 entries. When a 
block of contre vue file space is requested, this table is searched for a block 
of space equal to the amount requested, or the next largest block of space. 
The purpose is to allocate the smallest block that fits the size of the 
requested space. 


When a linked frame is requested, the frame is taken from the linked chain of 
file space. If there is no linked chain, the frame is taken from a contiguous 
block of file spacee When there is no contiguous file space, the linked chain 
of temporary space is searched. If still unsuccessful, the frame is taken from 
the contiguous block of temporary space. 


File space (both linked and Sone eee? is returned to the two file space 
tables. The system attempts to match the space up with an existing block in 
one of the tables. If the attempt fails, the space is returned to the linked 
chain of temporary space. 


Temporary Work Space 


Requests for temporary space are made in the following order: 1) the temporary 
linked chain, 2) the temporary block of contiguous space, 3) the contiguous 
block of file space (if successful, this space is proces in the temporary block 
of contiguous space), and 4) the linked chain of file space. 


The system attempts to give the epee back to the Femporery. block of contiguous 
space and to the contiguous bloc of file space. If the attempt fails, the 
frame is added to the Linked chain of temporary space. 


At the conclusion of the file-restore process on the SEQUEL > pan an initial 
condition may be said to exist; there will be one principal block of available 
high disc space, extending from the end of the current data space through the 
. last available data frame. This is illustrated in Figure A; the shaded area 
represents the used portion of the file area. As the system obtains and 
releases available space, the available space may get fragmented; at any 
particular time there may be several blocks of contiguous available space and a 
chain of linked frames. (The low disc space area is not eta eed subject to 
fragmentation because its space is usually obtained an released in Lange 
blocks as ata aes log on and off.) This is illustrated in Figure B; here the 
linked available chain starts at FID 8000 and contains 400 frames. Linked 
available space may be reorganized into contiguous available space via the 
CIAIM verb (refer to Chapter 9). The POVF verb may be used to display the 
available space. 
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DISC SPACE EXPLANATION 


ABS and 
primary work areas 


1474 
Low disc space «— (also available as 
ee Secondary File Area) 


6300 
Available high dise 
space 
505427 


START OF LINKED AVAILABLE CHAIN = (None) 
NUMBEK OF LINKED FRAMES = (None) 


Figure A. Example of Contiguous Available Space After a File-Restore 
DISC SPACE EXPLANATION 


ABS and 
primary work areas 


«— (also avatlable ase 
Secondary File Area) 


ie of avatlable linked chain 


Contiguous avatlable block 


J~i— Available Linked chain 


| Contiguous avatlable block 
Avatlable linked chain 


9250- a Avatlable linked chain 


: Contiguous avatlable block 
505427 


START OF LINKED AVAILABLE CHAIN = 6300 
NUMBER OF LINKED FRAMES = 400 


Figure B. Example of Fragmented Available Space 
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2.4 File Structure 


A file is a related group of items which can be accessed for retrieval and 


update operations by referencing the item-id, 


To understand the file structure, the following terms must be defined: 
Bit A digit in binary notation (either 1 or 0). 
Byte 


A unit of information consisting of 8 bits. Each character 


stored represents one byte, 


Synonymous to record. 


Item Usually made up of various attributes 
(fields) that describe an entity. An example is an inventory 
item with description and quantity fields. Maximum size is 
32,267 bytes. 

Item-id A unique datum (key) within a file item by which all of the 
data in the item is identified or referenced, such as a part 
number, Maximum size is 50 characters. May not contain 
multivalue or subvalue marks. 

Attribute A field within an item. 

Multivalues One of several values in the same attribute (field). 

Subvalues One of several values within a multivalue within an attribute. 

File A set of like items brought together for a like purpose. 

Group A set of linked frames (a frame = 512 bytes) where items may 
be sequentially stored. A group consists of one or more 
linked frames and can vary in size from file to file and 
within files. 

Base The FID (frame identification) of the first frame of the first 
group in a given file. 

Modulo The number of groups allocated for a given file. 

Separation The number of frames allocated for each group in a file. 


A set of items, each with a unique item-id, is stored in a file. 
defined by a base, modulo and separation. 


A file is 
This structure is illustrated in 


Figure A. 


You select the file modulo and separation when the file is initially created. 
Items are created and modified by the EDITOR, PROC, DATA/BASIC or other 
processors. Data is stored in items in terms of attributes, multivalues, or 
subvalues. 
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A hashing algorithm is used which operates on the item-id (using base, modulo, 
and separation) to produce an index to the FID of the first frame of the group 
in which the item is stored. For further information regarding this hashing 


algorithm, refer to the topic "Item Storage and Hashing Algorithm" in this 
chapter. 


last 
frame** 


512 bytes/frame 


*NUMBER OF GROUPS IS SPECIFIED BY "MODULO" 
**NUMBER OF FRAMES IS SPECIFIED BY "SEPARATION" 


Figure A. General File Structure 
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2.5 Item Structure (Physical) 


Data within an item is stored as attributes (i.e., fields), multivalues, and 


subvalues, all of which provide variable length storage. This topic describes 
the physical item format. 


An item consists of one or more variable-length attributes (also known as 
fields) separated by attribute marks. An attribute mark is an eight-bit byte 
with a value of X’FE’, which prints as an up-arrow or "“". An item is preceded 
by a four-character hexadecimal count which specifies the total number of 
characters in the item including the count field, the item-id, and an attribute 
mark to terminate the item. For example, consider the following item: 


OO2EITEMX*LINE 1*SMITH, JOHN~1234 MAIN STREET™~ 


In this example, the item-id is "ITEMX". It is preceded by "002E" which 
specifies that there are 002E (46) bytes in the item. Attribute 1 is "LINE 1". 
Attribute 2 is "SMITH, JOHN". The last attribute (attribute 3) is "1234 MAIN 
STREET". 


An attribute, in turn, may consist of any number of variable-length multivalues 
separated by value marks. A value mark has an eight-bit value of X’FD’, which 
usually prints as "J". Finally, a multivalue may consist of any number of 
variable-length subvalues (also known as _ secondary values) separated by 
subvalue marks. A subvalue mark has an eight-bit value of X’FC’, which usually 
prints as "\". For example, consider the following item: 


ITEM-I ATTR1 a en ar oy 
Bae ee ge ]7831\195\9\478] 775557 


LJ 
fem attea 
COUNT FIELD ATTR2 MULTIVALUES ATTR4 SUBVALUES 


The absence of an attribute value is specified by an attribute mark (to 
maintain the proper attribute sequence) immediately following the attribute 
mark indicating the end of the previous attribute. The "space" between two 
adjacent attribute marks can be thought of as representing the absent or null 
attribute. 


Note: An item-id must be less than 50 characters and the total size must not 
exceed 32,267 characters. 


Figure A illustrates the general form of an item. 
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attribute 
zero 


(item—id) attribute 


second 


subvalue i subvalue 


Figure Ae General File Item Structure 
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2.6 Item Structure (Logical) 


This topic describes the SEQUEL item structure at the logical level. 


While it is important to understand the physical item format, in normal system 
usage items are always accessed at a more abstract level. Files are identified 
by a file-name. Within a file, items are referenced by the item-id. 
Attributes are referred to as lines (i-e., Attribute 1 is called line 1). 
Figure A shows a sample COPY operation where the item with item-id ITEMX (in 
the file SAMPLE-FILE) is being copied to the terminal. The item is shown to 
have three attributes (lines) each with sample data. 


Utility processors like COPY and the EDITOR deal at the file-item-line level. 
They make no logical distinction in definition between various lines in an 
item, other than their implied line numbers. 


ENGLISH processors, however, add an additional dimension through the use of the 
dictionary. The dictionary informs ENGLISH as to the nature of information 
stored for each of the attributes. 


The logical item format is identical for ENGLISH and non-ENGLISH processors. 
It is your responsibility to ascertain further qualifications, if any, of the 
various attributes. For example, the item listing in Figure A, is show in 
Figure B, as produced by the ENGLISH LIST processor. Here, for example, the 
file dictionary defines Attribute 2 (line 2) as NAME and Attribute 3 (line 3) 
as ADDRESS. This permits you to reference data symbolically when, in fact, the 
actual data stored on file is the same regardless of the processor accessing 
it. (For further information, refer to the MICRODATA ENGLISH Programming 
Manual.) 
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FID 


Figure Ae Hashing Formula 


i forward Link 


FID: 38186 : 0 38197 0 0 ( 952A : 
000 seeeeSeecee OOLITATI“P~8 A 8700 1D ¥A 37A70377****T10 
050 “L7107170013SP-STOP~P~1 0A 6“00 1DSAMC~S*047S/AMC7™*** 
100 ““L~2~000C SUPP~CH~000BNOT~CD~00 2A LISTPROCS“PQ*(DIC 
150 T PROCLIB LISTPROCS)*O01DV/CORR“A*087*~****L“*1071~ 
200 0018T-RDLBL“P~6033780247000A EQ*CC*001E97S*09“V/TYP 
250 “097°"""L*27170016BLOC K-TERM~P~104170026ERRMSG~Q7S 
300 YSPROG~ERRMSG71°**""R75*001L6LTEM*P~2730A 07*NP*0013 
350 CHARGES”P~50327001 7C~READ“P~2794*“CUN*OO1DV/EDIT*A 
400 “1L27**"***L"1 0717001 LSUM*PW*35~4F~00 1A SSELECT*PB~3 
450 5°7673076~001E2*S*027A /AMC~027***"L~2~1~0029PE*PQ* 
500 HPRINT-ERR E 


FID: 38197 ; 0 0 38186 

O00 eoceseeee*®eeRRMSG “FTA (,999)"P“OOOEBEFORE~CB~~_LW. 
050 P2eep3eAe eGoQee] Poole coe cQpeeepees(s o60e NOs ofOepe 
100 Fe cBehe Bede oe QepoceeGeLlos Ne >PhesGe VB eZBsUeWeGe 
150 WeGe Po &GeFBe IBeEpeccccccec ce sMWeeeseeedePoeee Pep 
200 op eGeF@DNeIXsPe@D Ji JeeeelecpocccsesPeoJeGeVFIA0Get 
250 DeoeselCAPTQMR! Rewe so %GZee tANN_ BNG?“K@@.FBGT. .F6 
300 BGD.3.+GsFPoseUsoeseeeeG[ > Xo #BIV6e s BGVGHFANVBmVW 
350 2.QG ?.76.".U.++.B.VWZ.5XBmV. «Bgb«BjFsANVO666F.._ 
400 cee eR oe FG ee FOe Fees Fo ce Fe cd Foe Foe cetf 0G .OBQVWeee 
450 eeNse7NO soaccercececes eB5esBle s000000. -B5.eBls-00 
500 OOsseceoee S 


NOTE: The 


Figure B. 
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= BASE + [Remainder ((Function of item-id)/MODULO)] * SEPARATION 


hee Link 


0 9535 0) 


group= 
terminating 
attribute mark 


data after the group-terminating attribute mark ia random garbage 
and tse ignored by the system. 


Dump of First Group of Sample File 
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2.8 File Updates: Structure 


A single system routine handles all additions and deletions of items to files. 


Frames are added to groups as they grow and released as they shrink. Updates 
to items occur “in place". 


Figure A shows a file sparse enough to be contained in its primary space. It 
has a modulo of seven and a separation of one. 


As items are added to the file, new items will be added to the end of some 
groups (the groups to which these items hash). Also, items within the groups 
may shrink or grow. The position of items which shrink or grow is not changed, 
relative to other items in the group. (This is called "update in place.") 


As groups grow, frames are taken from overflow and appended to the ends of 
groups (Figure B). The primary space for the file remains unchanged. The 
appended frames will be singly linked together, as opposed to being contiguous 
blocks. 


When items are deleted, groups shrink and remaining items maintain their 
relative order. To make unused secondary frames available for other needs of 
the system, these frames are released to the system available space pool as 
soon as they become available. 
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FRAME 
1200 


A. File with Only Primary Space 


FRAME 


(1200. 


[i201] 


7 


1203 


(ins 


| 9700 _| 


9700 


Figure B. File Growth into Secondary Space 
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2.9 File Updates: File Update Routine 


One common routine is used for all file updates on a system. 


See Figure A for file update routine. 
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3 FILES AND DICTIONARY FILES 


SYSTEM 
M/DICT M/DICT M/DICT 


Dictionary Dictionary Dictionary Dictionary 
of file of file of file of file 
INVENTORY EMPLOYEE TAXRATE CUSTOMER 


Data of Data of Data of 
file file file 
INVENTORY EMPLOYEE CUSTOMER 


Figure A. Dictionary Hierarchy 


D/CODE TYPE OF DICTIONARY ITEM 
(Attribute 1) 


D File definition item. 


DX File definition item; the X indicates that the file will 
be skipped by the file-save processor. 


File definition item; the Y indicates that it is not 


required to save the data portion of the file on a 
file-save. . 


File synonym definition item. 


Attribute definition item. 


Figure B. Dictionary Items 
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3.2 File Definition Items 


File definition items define lower level dictionary files or data files. File 


definition items are specified by a D/CODE of "D", "Dx", or "DY". They are 
created automatically by the CREATE-FILE verb. 


At the SYSTEM dictionary level, file definition items define various system 
files (see the topic INITIAL SYSTEM FILES/DICTIONARIES), each user’s M/DICT, 
and an item containing the logon message. File definition items in the M/DICT 
define the dictionary level files which in turn may contain a file definition 
item which defines the associated data area. The item-id and each attribute of 
the file definition item contains the information used to describe the lower 
level dictionary or file: 


Item-id -~ The item-id of a file definition item is the file-name of 
the dictionary or data file being pointed to. 


Attribute 1 - This is the D/CODE attribute; it must contain a "D", 
"Dx", or "DY". See description of each in previous topic. 


Attribute 2 - This is the F/BASE attribute; it must contain the Base 
FID (as a decimal number) of the defined file. 


Attribute 3 - This is the F/MOD attribute; it must contain the modulo 
(as a decimal number) of the defined file. 


Attribute 4 - This is the F/SEP attribute; it must contain the 
separation (as a decimal number) of the defined file. 


Attribute 5 - This is the L/RET attribute; it may contain an optional 
retrieval security code (see Chapter 6, the topic titled 
SECURITY)» 

Attribute 6 - This is the L/UPD attribute; it may contain an optional 


update security code (see the topic in Chapter 6). 


Attributes 7 - These attributes are identical to those used in attribute 
through 8 definition items; refer to the topic, ATTRIBUTE 
DEFINITION ITEMS, in this chapter. 


Attribute 9 - This is the V/TYP attribute which indicates the type of 
justification for the column of item-ids printed by 
ENGLISH. A value is mandatory and may be one of the 
following: 


L - Left justified 

R - Right justified 

U - In user identification item in System Dictionary, 
indicates update accounting file 
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Attribute 10 - This is the V/MAX attribute which indicates the width of 
the item-id column printed by ENGLISH. A numeric value is 
mandatory. 


Attributes 11 - Reserved. 
through 12 


Attribute 13 - This is the F/REALLOC attribute, which allows for the 
reallocation of the physical extent of a file during a 
system file-restore process (see Chapter 4). The format 
of this specification is (m,s); where "m" and "s" are 
decimal numerics specifying the new modulo and new 
separation parameters of the file. Another way the 
physical extent of a file can be altered is to COPY the 
file to anew file. The first character may be a “B’ 
indicating to the file save/restore processor that’ the 
file is a pointer-file to saved lists of item-ids, 
cataloged DATA/BASIC programs and shared data items. The 
“B” is only valid at the System Dictionary level. 


WARNING: Attributes 2, 3, and 4 of a file definition item should never be 
altered under any circumstances. 


Figure A illustrates a sample file definition item which defines the dictionary 
level file for the INVENTORY file; this item has an item-id of INVENTORY and 
is stored in the user”s M/DICT. The figure also shows the file definition item 
which defines the data area of the INVENTORY file; this item has’ the special 
item-id “DL/ID“ and is stored in the file dictionary. 


Note that in a single-level file, the DL/ID item may be absent in the file 
dictionary, or it may point back to the dictionary itself. 


Item “INVENTORY~ in M/DICT 


ool 001 Dxt—— D/CODE=D (file definition item). 
002 002 15132—€ Base FID of file. 

003 13~+— Modulo of file. 

004 1~t—— Separatton of file. 

005~——_—- File access retrieval lock-eode. 

UPDATE*LOCK ! <——____ 006 -~«———- Update Loek/code. 

007 —— $$ $_$_________. 007 ~«—__—— Converston (null). 
008—<———________________ 008 ~<———____ Correlatives (nutt). 

009 L~w——. Left justification. 

010 10—e—— Colwm width. 

O11<—__——-._ (nuiZ). 

012 <«——_—- (null). 

013 (3,1)—- Reallocatton parameters. 


Figure A. Sample File Definition Item in M/DICT 
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3.3 File Synonym Definition Items 


File synonym definition items allow access to files in another user’s account 


or provide alternate file-names. File synonym definition items are specified 
by a D/CODE of "Q". 


The item-id and attributes of a file synonym definition item are: 


Item~id - The item-id of a file synonym definition item is the 
synonym name by which the defined file may be referenced. 


Attribute 1 - This is the D/CODE attribute; it must contain a "Q". 


Attribute 2 - This attribute must contain the name of the account in 
which the actual file definition is to be found (the 
account name is an entry in the System Dictionary). 


Attribute 3 - This is the S/NAME attribute; it must contain the item-id 
of the actual file definition item to which the synonym 
equates (iee., the actual file-name). If this attribute is 
null, then it is implied that the synonym file is the 
M/DICT of the account specified in attribute two. 


Attribute 4 - Must be null. 


Attribute 5 Not used. 


Through 12 


Note that a "Q-pointer" must point directly to a "D pointer"; one "Q-pointer" 
cannot point to another "Q-pointer". 


Figure A illustrates a sample INVENTORY file synonym definition item which 
allows you access to the file in the account named USER2; you can reference 
this file via the synonym file-name INV. Figure B illustrates the overall 
relationship of this plus an additional file synonym definition item. Note 
that SYNUSER3 points to the M/DICT for USER3 since the value for Attribute 3 is 
null. 
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Item “INV’ in USER1 M/DICT 


001 Q~—_________ D /copk= 


002 USER2 q——__——. Account name 
003 INVENTORY «—— File-name 
004 ~——__________ Null 


Figure A. Sample File Synonym Definition Item 


SYSTEM DICTIONARY 


USERID... 
—~ USER2“D*™...—— — 
. — USER3“D*..._— — 


USER1 M/DICT USER3 M/DICT 


INV — —- — 
001 Q 

002 USER2 

003 INVENTORY 
004 


SYNUSER3 


001 Q 

002 USER3 
003 

004 


° 


DICT INVENTORY 


DL/ID“D~... 
aa ae 


DATA INVENTORY D POINTER LOGICAL PATH 


Q POINTER LOGICAL PATH 


Figure B. Sample File Synonym Definition Interrelationship 
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3.4 Attribute Definition Items 


Attribute definition items define various attributes (fields) in the data items 
for use by the ENGLISH processor. Attribute definition items are specified by 
a D/CODE of "A", "xX" or "S", and are typically formed with the EDITOR. 


An attribute definition item defines a specific attribute (field) for 
subsequent access via the ENGLISH processor. Each attribute definition item 
has a value, called the Attribute Mark Count (AMC), which acts as a pointer to 
the data field defined by it. The AMC is simply the attribute number (eeg., 
AMC=5 defines Attribute 5, AMC=22 defines attribute 22, etc.). An attribute 
definition item defines a corresponding attribute for all items in the file and 
provides a symbolic name for that attribute. Attribute items with numeric and 
sequential item-ids (1,2,.-.) are used for the automatic attribute inclusion 
feature of ENGLISH (when the output-specification is omitted). "A" or "Ss" 
codes cause columns to be listed, and act identically with one minor exception, 
as noted under "Attribute 3" below. "X" codes preserve the chain of numeric 
item-ids but are otherwise ignored. Attribute definition items are constructed 
as follows: 


Item-id ~ The item-id is the name desired for the defined attribute. 
This name may be used in ENGLISH input statements to 
reference the attribute. 


Attribute 1 - This is the D/CODE attribute; it must contain an "A", '"S" 
or "X". 


Attribute 2 - This is the A/AMC attribute; it contains the AMC of the 
defined attribute (i.e., specifies which attribute is 
being defined). 


Attribute 3 - This entry will be used as the column heading. A 
multiple-line heading can be specified by separating 
individual lines with value marks (<c>], X’°FD’). If this 
attribute is null and the attribute definition item is an 
"A" type, then the column heading will default to the 
item-id of the attribute definition item. If this 
attribute is null and the attribute definition item is an 
's" type, then there will be no column heading. This is 
the only distinction between "A" and "S" type attribute 
definition items! 


Attributes 4 - Reserved. 


through 6 

Attribute 7 - This is the V/CON attribute; it contains the conversion 
specification used to convert from the processing format 
to the output format, and in some cases, vice-versa. 
Refer to the ENGLISH Programming Manual for further 
details. 


Attribute 8 - This is the V/CORR attribute; it contains the correlative 
specification used to convert from the internal format to 
the processing format (refer to the ENGLISH Programming 

Manual). 
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Attribute 9 - This is the V/TYP attribute; it defines the justification 
for outputs A value is mandatory and may be one of the 
following: 

I - Left justified, wrapped text is indented one Space 
L = Left justified, no specified type 

R - Right justified, no specific type 

T - Text data, left justified. Fold at blanks. 

U- Left justified, print entire value on line, ignoring 


column boundaries. 


Attribute 10 - This is the V/MAX attribute; it defines the column width 
in which values for the attribute will be printed. An 
entry is a decimal numeric, and is mandatory. Note, 
however, that if this attribute is less than the width of 
the column heading specified in Attribute 3, the width of 
the column heading will override the width specified here. 


Attributes 11 - Used by SCREENPRO. 
through 20 


Figure A illustrates a sample attribute definition item which defines the third 
attribute of each item in the inventory file. Figure B shows a_ sample 
attribute item which defines the fifth attribute of each item in the employee 
file. 


Item “QUANTITY’ in dictionary of file INVENTORY 


001 A «———_——_ D /CODE=A 
002 3 «——_—_—_—-. AMC’ (defines 3rd attribute) 
003 QTY«—————-. Colunm heading 

004 

005 

006 

007 MD2 «——_——_—- Conversion spectfication 
008 G*l~t——__—-. Correlative spectfiecation 
009 R~t—————_—— Right justified 

010 10<——————- Column width 


Figure A. Sample Attribute Definition Item 


Item “RATE” in dictionary of file EMPLOYEE 


0OL A~——_——---— D /CODE=A 

002 5<e—————— AMC (defines 5th attrtbute) 
003 

004 

005 

006 

007 MD2$<———— Conversion specification 
008 


009 L~————- Left justified 
010 5 ———_—_—_——. Column width 


Figure B. Sample Attribute Definition Item 
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3.5 Summary of Dictionary Items 


This topic summarizes items used in various SEQUEL dictionaries. 


File and Attribute Definition Items 


The file definition items, file synonym definition items and attribute 
definition items which may be used as dictionary entries are summarized in 
Figure A. 


System Dictionary (SYSTEM) Items 


There is one and only one System Dictionary for each SEQUEL system. The SYSTEM 
dictionary should contain only items with D/CODE=D, DX, DY, or Q, representing 
user accounts or special system files. (The exception is the LOGON message; 
refer to the topic SYSTEM MESSAGE FORMATS: LOGON MESSAGE.) The Logon processor 
uses these "D' type items to verify users attempting to logon to the system. 
Only one "D" type item should be present for each account; if more than one 
user-name is to be established for the same user-account, additional names 
should be file synonym definition ("Q" type) items. 


Master Dictionary (M/DICT) Items 


There is one M/DICT for each account. The M/DICT, like any other file or 
dictionary, is made up of items. Items with D/CODEA or S define the attribute 
formats for all dictionaries including the M/DICT itself; their formats are 
identical to those for dictionary level files. The file-defining items 
(D/CODE=D) point to various files defined for the account. 


In addition to elements in the M/DICT which define files and attributes, there 
are items which define verbs, PROCs, and various ENGLISH language elements. 
Each of these items has a coding structure which uniquely identifies it; refer 
to the following sources for their respective definitions: 


. The chapter titled TERMINAL CONTROL LA NGUA GE 


‘ PROG Programming Manual 
. ENGLISH Programming Manual 
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FILE ATTRIBUTE 


FILE SYNONYM ATTRIBUTE CONTINUATION 
ATTRIBUTE DEFINITION DEFINITION DEFINITION DEFINITION 
NUMBER NAME ITEM ITEM 


2 F/BASE Base FID of Account- 
or A/AMC | file name 
F/MOD or | Modulo of 
file File-name 


Separation Must be 
null 


Not used 
and reserved 


Alternate 
heading 


Update lock <Not used and reserved ———_—_—_—_» 


Conversion 
specification(s) 


Not used 
and reserved 


Conversion 
specifica- 
tion(s) 


Correlative 
specification(s) 


Not used 
and reserved 


Correlative 
specifica- 
tion(s) 


Justification! Not used Justification type 
type code and reserved| code 


10 V/MAX Column width | Not used Column width 
and reserved 
1l 


a |e tot used and reserved —————_____... 
—+—___—_—————-Not used and reserved~>| Used by SCREEN PROCESSOR 


F/REALLOC Reallocation |~«————wnot used and reserved ——_—_—_____»> 


specification 


Not used and 
reserved 


Used by 
SCREENPRO 


Figure A. Summary of File and Attribute Definition Items 
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3.6 Initial System Files/Dictionaries 


Certain files are essential to the operation and maintenance of the SEQUEL 
system. This topic describes these files. Figure A illustrates’ the 


interrelationship of these files. 


SYSPROG Account 


The System Programmer (SYSPROG) account is the only account needed to maintain 
the SEQUEL system. The system message file (ERRMSG) and the prototype M/DICT 
(NEWAC) are defined in this account. The former is accessed by all users of 
SEQUEL to obtain error and informative messages, while the latter is used to 
create new user M/DICT’s. Also contained in the SYSPROG account are the 
system-level PROCs which perform the file-save and file-restore functions, the 
initialization of the Accounting History file (ACC) on a system setup, etc. 


ERRMSG File 


This dictionary level file, defined from the SYSPROG account, contains the 
system messages- Entries in the ERRMSG file are listed in the appendix to this 
manual; they consist of both error messages and informative messages. 


SYSPROG-PL File 


This dictionary level file contains the system maintenance PROCs. These PROCs 
can be used from the SYSPROG account. Refer to Chapter 11, SYSTEM MAINTENANCE 
PROCEDURES, for a full description of the entries in this account. 


NEWAC File 


This dictionary is defined from the SYSPROG account, and is a prototype M/DICT 
used as a model from which a new user’s M/DICT is created. The NEWAC file is 
used by the CREATE-ACCOUNT PROC. 


Accounting History File 


The Accounting History File (ACC) and dictionary (DICT ACC) contain the 
accounting history for the system, as well as entries that describe currently 
active users. The formats of these entries are described in Chapter 6, 
LOGON/LOGOFF. The Accounting History file should be cleared periodically. 


PROCLIB File 


The PROCLIB file contains a number of common PROCs (e.g., LISTU, CT, etc.). 
Each M/DICT contains a Q=pointer to PROCLIB, along with short versions of the 
common PROCs (using the same PROC names), which merely transfers control to the 
corresponding PROC in PROCLIB. For further information, refer to the PROC 
Programming Manual. 
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BLOCK-CONVERT File 


This file contains items used by the BLOCK-TERM and BLOCK-PRINT verbs to 
convert characters to a block format. 


POINTER-F ILE 


This file contains pointers to saved select lists, cataloged DATA/BASIC 
programs, etc. Do not modify this file! Attribute 13 of the file definition 
item in the SYSTEM dictionary must contain a °B’ as the first character. 


SYSTEM-OBJECT File 


This file contains assembly object code for all Microdata supplied system 
software. These items are loaded via the MLOAD verb into the ABS region from 
which the code can be executed. (Refer to the SEQUEL Assembly Language 
Programming Manual for further ‘details.) Some items in this file are used to 
create the coldstart (bootstrap) portion of a file~save tape. 


Pointers 
to each 


user’s 
SYSTEM M/DICT 
DICT ACC PROCLIB BLOCK= POINTER= 
CONVERT FILE 


SYS PROG 
ERRMSG SYS PROG=PL SYSTEM~OB JECT 


Figure A. General Organization of Initial Files/Dictionaries 
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4.1 DMP Overview 


All SEQUEL systems have a Diagnostic Maintenance Processor (DMP) board. With 
the DMP, Microdata Customer Service Engineers perform various diagnostic tasks, 
such as using the Firmware Debugger and executing diagnostic programs. You may 


fuse the DMP to: 1) boot the system, and 2) access the system when system 
software becomes inoperable. 


You access the DMP from either Port Zero or a remote port (used for diagnostic 
testing). If the remote port is used, the REMT button must be pressed. 
Whatever appears on the remote terminal will also appear on Port Zero’s 
terminal. 


You can activate the DMP by powering up the system or by switching the key 
switch to TEST and typing <c>D on the remote terminal or Port Zero. The DMP 
first executes diagnostic programs. These tests may take several minutes to 
execute (see section titled EXECUTING SEQUEL SELF TESTS). When the tests are 
complete, the DMP displays the System Control Menu (see Figure A). 


SEQUEL Control Panel 
The SEQUEL Control Panel has switches, lights and the REMT button to select and 


reflect the operational mode of the DMP and main CPU. The functions of the 
switches, lights and the REMT button are as follows: 


4~Position Key Switch 


OFF All system power is off. 
HOLD Power is supplied to memory only. 
RUN Power is supplied to the entire system. If the switch is 


turned from OFF to RUN, the System Control Menu is 
displayed. To start the operating system, you must perform 
a coldstart (’X’ option). If the switch is turned from HOLD 
to RUN, the system returns to the previous RUN state. 

TEST Power is supplied to the entire system. If the switch is 
turned from OFF to TEST or from HOLD to TEST, the System 
Control Menu is displayed. To start the operating system, a 
coldstart ("X” option) must be performed. When in the TEST 
position, the DMP firmware responds to the <c>D from. the 
keyboard. If the key is turned from RUN to TEST to RUN, no 
effects are generated. 


REMT button This is a button that generates an interrupt to the DMP, 


allowing the firmware to select either the local or the 
remote terminal for Port Zero. 


42 83-1109 


4 DIAGNOSTIC MAINTENANCE PROCESSOR (DMP) 


Lights 
PWR Power is available to the entire system. 
RDY The hardware is ready to run. 
BUSY The SEQUEL bus is busy. 
ERR The DMP self-test is running, or the DMP self-test has 
encountered a fatal error condition. 
TEST The DMP is in the diagnostic mode. 
REMT The remote console keyboard is selected. 


Figure B illustrates the SEQUEL DMP control panel. 


* * * SYSTEM CONTROL MENU * * * 


SYSTEM FUNCTIONS 
1- RESET SYSTEM 
2- BOOTLOAD 
3— ENTER FIRMWARE DEBUGGER 
4— STOP CPU 
5~- RESUME CPU PROCESSING 


TERMINAL FUNCTIONS 
6- SWITCH CONTROL TO LOCAL/REMOTE TERMINAL 
7- CHANGE BAUD RATE 


DIAGNOSTIC FUNCTIONS 
8- RUN CPU FIRMWARE DIAGNOSTICS 
9—- RUN DMP FIRMWARE DIAGNOSTICS 
10= DISPLAY/ALTER MEMORY 


ENTER OPTION (1-10) : 


Figure A. SEQUEL System Control Menu 


HDEN WTEN 


LOAD ONL REWD PWR RDY BUSY ERR TEST REMT. 


OFF 


Figure Bs SEQUEL DMP Control Panel 
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4.2 Powering Up a SEQUEL System 


If your SEQUEL system is powered down via the key switch or due to a power 
failure, you must power up the CPU. The system begins by running diagnostic 
tests. During the course of the tests, the disc units are activated. Should 


the tests encounter no errors, main memory is still intact, and the key switch 
is in the RUN position, the system will continue processing where it left off. 
If main memory is lost or if the key switch is in the TEST position, the system 
displays the message "POWER FAIL, COLDSTART REQUIRED". 


There are three ways to power-up your SEQUEL system. Where the key switch is 
positioned prior to power-up determines what method you should uses Each 
method is explained below. 


Method #1: (Power-up, memory contents destroyed) 


a. Turn 4-position key switch from OFF to RUN, or 
Turn 4-position key switch from OFF to TEST. 

be There is a six second delay to stabilize the power supply. 

c. The message "POWER UP" is displayed on the terminal screen (see Figure 
A). 

ds CPU initializes memory to remove memory parity errors caused by the 
memory power fail. The maximum time required to initialize memory is 
approximately six seconds. If the CPU does not acknowledge the 
completion of the initialization task within six seconds, the message 
"NO CPU ACKNOWLEDGEMENT (B)" is displayed. 

e. If the system is started or restarted from the power fail condition, 
the system time is set to 00:00:00. If the system date is destroyed, 
you must reset it. 

f. If the message "POWER FAIL" appears on the screen, mount a bootload 
tape on the tape unit (close tape unit door securely) and press <c>D to 
bring up the System Control Menue To the message “ENTER OPTION 
(1-10):", enter "2" (BOOTLQAD) and perform a coldstart (’X” option). 


Method #2: (Power-up, Contents of Memory Not Destroyed) 


ae Turn 4-position key switch from HOLD to TEST, or 
Power-up with key switch in TEST position. 

be There is a six second delay to stabilize the power supply. 

ce The message "POWER UP" is displayed on the terminal screen (see Figure 
B)e 

d. Self-tests are executed. See the following section for more detailed 
information. 
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Method #3: (Power-up, Contents of Memory Not Destroyed) 


ae Turn 4-position key switch from HOLD to RUN, or 
Power-up with key switch in RUN position. 

be There is a six second delay to stabilize the power supply. 

ce The message "POWER UP" is displayed on the terminal screen (see Figure 
B). 

d. Self-tests are executed (see following section for detailed 
explanation). 


WARNING: This option should not be used unless the CPU was previously 
executing a valid program. 


POWER UP 


--RUNNING CPU FIRMWARE DIAGNOSTICS 
CPU STATUS 01000000 GOOD STATUS 
--RUNNING IOP SELF TEST 

--RUNNING DISC SELF TEST 
--STARTING DISC MOTORS 

--RUNNING ACLC SELF TEST 

--RUNNING MAG TAPE SELF TEST 

SELF TESTS COMPLETED 


POWER FAIL -= COLDSTART REQUIRED 


ENTER RETURN TO DISPLAY CONTROL MENU 


Figure A. Sample Screen Display of Method #1 (Assuming No Error Messages) 


POWER UP 


--RUNNING CPU FIRMWARE DIAGNOSTICS 
CPU STATUS 01000000 GOOD STATUS 
--RUNNING IOP SELF TEST 

--RUNNING DISC SELF TEST 
--STARTING DISC MOTORS 

--RUNNING ACLC SELF TEST 

-~RUNNING MAG TAPE SELF TEST 

SELF TESTS COMPLETED 


ENTER RETURN TO DISPLAY CONTROL MENU 


Figure B. Sample Screen Display of Methods #2 & #3 (Assuming No Error Messages) 
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4.3 Executing SEQUEL Self Tests 


The SEQUEL system automatically performs DMP Firmware and 1/0 Controller Self 


Testse Each test is described below. 


DMP Self Tests 


DMP Self Tests examine the internal operation of the DMP. When the self tests 
begin, the ERR light is turned on and the RDY light is turned off. If the 
tests are completed without errors, the ERR light is turned off and the RDY 
light is turned on. 


Execution of these self tests should take no longer than one second (exception: 
when powering up, there is a six second delay). Should the ERR light stay on 
indefinitely, the DMP has encountered an error condition that it cannot report 
to the terminal. 


CPU Firmware Tests 


The Firmware Tests follow the execution of the DMP Self Tests. Upon their 
execution, the message 


-- RUNNING CPU FIRMWARE DIAGNOSTICS 


is displayed. If the diagnostics are completed without errors, a status 
message such as 


CPU STATUS 01000000 GOOD STATUS 


is displayed. However, should errors occur, appropriate error messages are 
displayed (refer to the section titled DMP SYSTEM CONTROL MENU). Time required 
to execute these tests is two seconds per memory board. 


I/O Controller Self Tests 


If the Firmware Tests are executed successfully, the I/O Controller Self Tests 
are run. Each test is examined below: 


IOP Self Test When executed, the message 
--RUNNING IOP SELF TEST 
is displayed. There are two IOP controllers. 
Their device addresses are FB and FC, 
respectively. FB must always be present; if 
missing, an error message is displayed. If FC 


is missing, no error message is printed. 


Time required to execute this test is less than 
one second. 
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Dise Self Test 


ACLC Self Tests 


Magnetic Tape Self Test 


SELF TESTS COMPLETED 
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When executed, the messages 


--RUNNING DISC SELF TEST 
--STARTING DISC MOTORS 


are displayed. 

If a disc drive is not ready, the program waits 
12 seconds before starting the next disc drive. 
When waiting for the disc drives to come ready, 
the program will wait up to 60 seconds per 
drive for the status interrupt to occur. Error 
conditions (except for missing or not-ready 
drives) are reported. 
When executed, the message 

--RUNNING ACLC SELF TEST 

is displayed. 


Error conditions (except for missing ACLC 
boards) are reported. , 


Time required to execute these tests is 
approximately 20 seconds per ACLC board. 


When executed, the message 
--RUNNING MAG TAPE SELF TEST 
is displayed. 


Error conditions (except for missing boards) 
are displayed. 


Time required to execute this test is 
approximately two seconds. 


After the Mag Tape Self Test is completed, the 
message 


--SELF TESTS COMPLETED 
is displayed. 
There is a 0-5 second delay between the above 


message and the next message to appear on the 
screen. 
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4.4 DMP System Control Menu 


The DMP System Control Menu enables you to 1) reset the system, 2) bootload 
the system, 3) enter the Firmware Debugger, 4) stop the CPU, 5) restart the 


CPU, 6) toggle the local/remote terminal, 7) change the baud rate for Port 
Zero, 8) execute CPU firmware diagnostics, 9) execute DMP firmware 
diagnostics, and 10) display/alter the contents of main memory. 


To display the System Control Menu, turn the key switch to TEST and enter a 
<o>D. Options One and Two are defined below. Options Three through Ten are 
described briefly in the following section. 


Option 1 - RESTART SYSTEM 


This option resets the CPU and all controllers, This means that all current 
I/O operations are destroyed, and you must do a coldstart. 


To execute this option, type in "1" and press the RETURN key. The message "DO 
YOU WANT A SYSTEM RESET? (Y/N)" will be displayed. To execute a system reset, 
type in "Y" and RETURN, To abort the system reset, type in "N" and RETURN. 
The System Control Menu will then be displayed. 


WARNING 
This option is not comparable to an "IRI" sequence on a REALITY system. Once 


this option is executed, a warmstart can not be performed; a coldstart is 
required. 
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* # SYSTEM CONTROL MENU # # & 


SYSTEM FUNCTIONS 
1=- RESET SYSTEM 
2= BOOTLOAD 
3- ENTER FIRMWARE DEBUGGER 
4~ STOP CPU 
5- RESUME CPU PROCESSING 


TERMINAL FUNCTIONS 
6- SWITCH CONTROL TO LOCAL/REMOTE TERMINAL 
7~- CHANGE BAUD RATE 


DIAGNOSTIC FUNCTIONS 
8- RUN CPU FIRMWARE DIAGNOSTICS 
Q- RUN DMP FIRMWARE DIAGNOSTICS 
10- DISPLAY/ALTER MEMORY 

ENTER OPTION (1-10) 


DO YOU WANT A SYSTEM RESET? (Y OR N) 


Figure A. Sample Dialogue of RESET SYSTEM Option 
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Option 2 - BOOTLOAD 
The bootload is the procedure for loading all or part of the software in order 
to bring the system to a run state. The bootload loads the software from 
magnetic tape. 
To execute this option: 

1. Mount a file-save or binary-save tape on the tape unit. 

2. Close the tape unit door securely. 

3. Press the LOAD button twice. 

4, Press the ONL button once. 


5, When the "ENTER OPTION (1-10) :*® prompt is displayed, enter m2" and 
press the RETURN key. 


6, Enter the option you have selected. 
Before the bootload sequence is initiated, the automatic diagnostics are 
executed to verify system integrity. The "OPTIONS" message indicates that the 


bootload is completed and the system is running the monitor. Each of the 
options listed in the "OPTIONS" message is discussed later in this chapter. 
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# # # SYSTEM CONTROL MENU # # # 


SYSTEM FUNCTIONS 
1- RESET SYSTEM 
2= BOOTLOAD 
3~ ENTER FIRMWARE DEBUGGER 
4— STOP CPU 
5- RESUME CPU PROCESSING 


TERMINAL FUNCTIONS 
6- SWITCH CONTROL TO LOCAL/REMOTE TERMINAL 
7~ CHANGE BAUD RATE 


DIAGNOSTIC FUNCTIONS 
8- RUN CPU FIRMWARE DIAGNOSTICS 
Q=- RUN DMP FIRMWARE DIAGNOSTICS 
10- DISPLAY/ALTER MEMORY 


ENTER OPTION (1-10) 
--RUNNING IOP SELF TEST 
--RUNNING DISC SELF TEST 
~-STARTING DISC MOTORS 
--RUNNING ACLC SELF TEST 
--RUNNING MAG TAPE SELF TEST 
SELF TESTS COMPLETED 
ENTER BOOTLOAD DEVICE NUMBER (1,2,3,4): 
OPTIONS (W,X,A,F,AF,D) = 


Figure A. BOOTLOAD Dialogue 
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4.5 DMP System Control Menu - Options 3 - 10 


Options Three through Ten of the System Control Menu are defined below. 


WARNING: These options are for Customer Service use only- Do not execute 
without first consulting your Microdata Service Representative. 


Option 3 - ENTER FIRMWARE DEBUGGER 


This option activates the Firmware Debugger. You may also enter the Firmware 
Debugger by typing a <c>F from Port Zero’s terminal when the key switch is in 
the TEST position. To leave the Firmware Debugger, enter an "X" at the 
debugger prompt (">"). Entering an "X" takes you to the system (user) program. 
To return to the menu, enter <c>D. 


If the system entered the Firmware Debugger on its own, or you are not sure how 
it happened, contact your Microdata Technical Support Representative 
immediately. 


Option 4 - STOP CPU 


This option halts the CPU and disables all interrupts except the DMP handshake 
interrupt to the CPU. 


To execute this option, enter "4" and press the RETURN key. 


Option 5 - RESUME CPU PROCESSING 


This option tells the CPU to continue processing. Interrupts from operations 
that were on-going when the STOP CPU option was executed will now be allowed to 
take place. 


To execute this option, type in "5" and press the RETURN key. 


Option 6 ~ SWITCH CONTROL TO LOCAL /REMOTE 


This option selects either the local (Port Zero) or remote mode to control the 
DMP. 


To execute this option, type in "6" and press the RETURN key. The message 
"LOCAL OR REMOTE (L OR R)?" will be displayed. If in the local mode, type in 
"R" and RETURN to switch input/output to the remote terminal. If in the remote 
mode, type in "L" and RETURN to switch input/output to Port Zero. Note: The 
baud rate must be set per requirements for the modem/data phone before 
selecting the remote mode. 


Option 7 -— CHANGE BAUD RATE 


This option enables you to change the baud rate for both the local (Port Zero) 
and remote terminal. 
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To execute this option, type in "7" and press the RETURN key. The message: 


ACCEPTABLE BAUD RATES FOR DMP AND ACLC ARE: 
50, 75, 110, 134.5 
150, 300, 600, 1200 
1800, 2000, 2400, 3600 
4800, 7200, 9600, 19.2K 
ENTER ACCEPTABLE BAUD RATE FOR YOUR TERMINAL: 


is displayed. Type in the desired baud rate and press the RETURN key. Garbled 
data will appear on the screen. Set the baud rate selector on the terminal to 
the desired baud rate and press the RETURN key again. The System Control Menu 
will then be displayed in readable characters. 


Option 8 —- RUN CPU FIRMWARE DIAGNOSTICS 


This option executes a diagnostic program. To execute, type in "8" and RETURN. 
The message "CPU HALTED" is displayed. After four seconds the following option 
menu is displayed: 


CPU FIRMWARE DIAGNOSTIC MENU 


- SINGLE RUN, ALL TESTS 

~ SINGLE RUN, SELECT TESTS 

~ LOOP ON TESTS, STOP ON ERROR 
~ LOOP ON TESTS, LOOP ON ERROR 


FWNe 


ENTER OPTION (1-4): 


Type in the desired option and press the RETURN key. These tests destroy CPU 
registers. As a minimum, a warmstart is required to continue CPU execution; a 
coldstart is permissible. 


Option 9 - RUN DMP FIRMWARE DIAGNOSTICS 


To execute this option, type in "9" and RETURN. The screen is cleared and the 
diagnostic menu is displayed. Type in the desired option number and press the 
RETURN key. 


WARNING: Because some of these tests are destructive to the system, do not 
execute this option without first consulting with your Microdata 
Customer Service Engineer. 


Option 10 - DISPLAY/ALTER MEMORY 


This option enables you to display and/or alter memory locations in the SEQUEL 
memory. After entering "10", the following information is displayed: 


DISPLAY/ALTER MEMORY OPTIONS 

W = DISPLAY WORD 

B = DISPLAY BYTE 

SPACE = DISPLAY NEXT LOCATION 
CTRL A = DISPLAY CURRENT LOCATION 
RETURN = TERMINATE 


> 


The ">" is a prompt for a command. To alter memory, first display the location 
and then type in the desired new data. To return to the System Control Menu, 
press the RETURN key three times. 
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4.6 System Restore: Overview 


System restore is the process of “bringing up", or making operational, the 
SEQUEL system. A SEQUEL system is brought up by doing a file-restore from 
tape. This procedure transfers system software, dictionaries, and data from 
tape through main memory onto the discs. It also establishes the monitor in 
the low portion of main memory. Furthermore, the system configuration (number 
of terminals, number of discs, etc.) is established at this time. 


A system restore is performed using a save tape (or a SYS-GEN tape). A save 
tape has three parts; each section is terminated by an end-of-file mark (see 
Figure A). 


1. The bootstrap section contains the monitor, the configurator, and some 
virtual memory frames needed to bootstrap the system. 


2. The ABS (absolute) section contains the majority of system software. 


3. The files section restores the data base including all accounts, 
dictionaries, as well as DATA/BASIC object code. 


The bootload process is controlled by the Diagnostic Maintenance Processor 
(DMP). The bootload option on the DMP”s Control Menu is used to load the 
bootstrap section of the tape. 


To pring up a system from scratch, place a file-save tape on the magnetic tape 
unit. Turn the key switch to RUN. The DMP will run the self-tests and then 
display the Control Menu. To the prompt "ENTER OPTION (1-10) :", type "2" 
followed by <RETURN> to start the bootload. The self-tests are run again. If 
there are no errors, the "OPTIONS" message is displayed. Respond with "AF" to 
the message “OPTIONS (W,X,A,F,AF,D)" for a complete system restore (see Figure 
B). 


When a complete system restore (option “AF”) is performed, the system 
configuration is determined. When a coldstart (“X”), files only (“F~), or ABS 
only (“A*) restore is performed, most aspects of the configuration must be 
maintained, although some portion of main memory may be changed within Jlimits. 
The warmstart (“W~) option restarts a system halted during normal operation. 


The “D* option is used by SEQUEL customer engineers for formatting disc 
platters and verifying check-codes. If this option is inadvertently entered, 
you may recover by rewinding the tape and restarting the system load. 


After you respond to the "OPTIONS" message, the configuration software 
determines the following: 


» Number of communication lines 


1 
2. Amount of main memory 
3 Number and size of all disc drives 
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These are compared with limits set inside the hardware, and in each case the 
smaller number is selected for the system. 


Should you have I/O errors, such as parity errors during the bootload, one of 
the following messages is displayed: 


TAPE ERROR, RECORD n; STATUS = xxxxxxxx 
or 
TAPE ERROR 


The first message is displayed by the firmware if the error occurred in the 
first or second record. The status allows a Microdata Customer Service 
Engineer to determine exactly what is wrong. The second message is printed by 
the software if the error is in any other record. In this case, the status is 
stored in memory. 


BOOTSTRAP 
(LOADED BY FIRMWARE) EOF MARK 
py TAPE LABEL RECORD 


(LOADED BY CONFIGURATOR) 


es es ABS SECTION 
COLDSTART SECTION (LOADED BY PROCESS ON LINE 0) 


rs 


EOF MARK 


T-DUMP OF 
FILES SECTION EOF oe STAT~FILE 


Figure As Sections of a Formatted File-Save Tape 


OPTIONS (W,X,A,F,AF,D) = 


WARMSTA RT 
COLDSTART 


COLDSTART; RESTORE ABS 

COLDSTART; RESTORE FILES; CLEAR SPOOLED JOBS 
COLDSTART; RESTORE ABS AND FILES; CLEAR SPOOLED JOBS 
DISC FORMATTER 


Figure B. Options Message 
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4.7 Complete System Restore: Load Dialogue 


The configurator passes control to a virtual process on Line Zero which loads 
the system software and all the files. When you respond with ‘AF’ to the 
"OPTIONS" prompt, the configurator loads the proper disc tables, calculates the 
maximum FID, and the System Dictionary Base. It configures the main memory 
buffer tables, etc. Configuration limits are set by the firmware; the 
parameters are displayed on Line Zero’s terminal. 


The following lines may appear on Terminal Zero’s screen: 


1. The assigned spooler port is listed. 

2. The prompt “ENTER NUMBER OF TIPH LINES:" appears if the spooler’s line is 
not the last port (iee., if the spooler’s line is 127, this prompt will not 
appear). Pressing RETURN defaults to 0 TIPH ports. When performing an ‘AF’ 
restore, the system uses this number to determine the base of the SYSTEM 
file. Therefore, for all restores other than an “AF” restore, you must 
specify the same number each time the system prompts for this response; if 
you are performing an ’AF’ restore, you may change this number. 

3. The amount of main memory is displayed. This will be the smaller of the 
hardware limit and the amount of memory sensed. 

4. A listing of the disc drives, the device address of the disc controller and 
the number of heads is displayed. This list is the smaller of the sensed 
disc configuration and the configuration specified in the hardware. 

5« You are asked "CONFIGURATION CORRECT (Y/N)?" At this time it is important to 
verify that the correct configuration is displayed to prevent disc 
mismapping. Answer "Y" if the display is correct; a response of "N" causes 
the "OPTIONS" message to be displayed. 

6. The prompt “OTHER OPTIONS?" appearse An "N" or <cr> (normal) response 
causes the subsequent file load to honor reallocation parameters (Line 13 of 
D-pointer items), if present. A response of "R" inhibits reallocation. 


Next, the ABS restore proceeds automatically. As the ABS restore continues, 
this message is completed: A1-1215, indicating that Frames 1 through 1215 have 
been loaded. This concludes the load of the system software. 


Between the ABS restore and the file-restore, the remaining lines are activated 
and sent to LOGON. The spooler is started on the last line as indicated by the 
message "SPOOLER STARTED", and all system software locks are initialized. At 
this time you are asked to enter the correct date and time. 


The file section is restored next. As the file load proceeds, a series of 
messages appear on the screen which identify the files being loaded. When the 
file-restore finishes, the system load is completed, and all ports are at 
LOGON. All that remains to be done is to run the SYSTEM~SETUP PROC (refer to 
the topic "INITIALIZING THE SYSTEM: SYSTEM-SETUP"). 
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OPTIONS (W,X,A,F,AF,D) = 
120 IS THE SPOOLER’S LINE 
ENTER NUMBER OF TIPH LINES: 
1024K OF MEMORY Configurator 
DRIVE DO, REFLEX-LII 

DRIVE D1, REFLEX-II 
CONFIGURATION CORRECT? (Y/N): 
OTHER OPTIONS? © 


~-_————— Complete restore 


TAPE SIZE CHANGED TO 08192 


Al - 1215 \ ABS 


SPOOLER STARTED 9 <————_______ The system Locks are intttalized 
at thts potnt. 


ENTER DATE. (MM/DD/YY)...11/10/82 


ENTER TIME. (HH:MM:SS)...16:46:00 
16:46:00 10 NOV 1982 


CORRECT TIME AND DATE? (Y/N): 


SYSTEM 6080,11,1 
BLOCK-CONVERT 6091,7,1 
DL/ID 0U91,7,1 (S$) 
CHANNEL 6098,1,1 

DL/ID ©099,7,1 

DL/ID 6U80,11,1 (Ss) 
PROCLIB 6106,7,1 
DL/ID 6106,7,1 (S) 
POINTER“FILE 6113,5,1 
DL/ID 6113,5,i (S) 

SYSTEM 6080,11,1 (S) 
SYSPROG 6118,69,1 
MD 6118,69,1 (S) 
M/DICT 6118,69,1 (S) 
DL/ID 6118,69,1 (S) 

STAT-FILE 6187,1,1 
DL/Ib 6188,87,1 


Files 


LOGON PLEASE: 


Figure A. Complete System Load Dialogue 
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4.8 System Configuration for Complete Restore: Disc Space Assignment 


The location of the SYSTEM dictionary is determined by the hardware. It 


follows the ABS area, process work spaces, and a region of low disc space. 


Each process (as specified by the hardware) is assigned 32 frames of work 
spacee All ABS frames are restricted to the region below Frame 4096. The 
region of available low disc space is 200 frames per process. This area is 
used as second priority by the file restore, and first priority in obtaining 
LOGON workspace. (See the topics, WORK SPACE ASSIGNMENT in Chapter 6 and LOW 
DISC SPACE AREA AND FILE AREA in Chapter 2.) 


The FID of the PCB of the process on Line zero is called PCBO. This will be 
one more than the number of ABS frames. 


The base of the System Dictionary is calculated by: 

SYSTEMBASE = (FID of first PCB) + ((number of processes) *232) + 1 
The maximum legal (and usable) frame number (FID) for the system is calculated 
by listing the number of disc platters included in the system. Then use the 
formula: 


Maximum FID = number of REFLEX=-II drives * 249536 = 1 


This calculation is illustrated in Figure B. Figure A illustrates the physical 
arrangement of the frames. 
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SYSTEM MAX 


qa SYSTEM 
DICTIONARY 


LOW AVATIABLE SPACE 


Figure A. Disc Space Assignments 


Drive 0 
Drive l 


total number of drives = 2 


maximum fid = 2 * 249536 - 1 = 499071 


Figure B. Calculation of Maximum FID for a System with Two Disc Drives 
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4.9 Warmstart 


A warmstart allows you to restart the monitor. This section describes when 


and how to do a warmstart. 


If any of the system's terminals hang, and it is suspected that the monitor 
has stopped operating correctly, it is desirable to perform a warmstart from 
tape. If the system failed when work was in progress, the warmstart is the 
only way to restart the system without loss of work in progress. Performing a 
warmstart reloads only the system monitor. In addition to reloading the 
system monitor, a warmstart also flushes memory, in case a coldstart has to be 
performed. 


CAUTION 


NEVER PERFORM A WARMSTART AFTER CHANGING OR SWAPPING THE SYSTEM'S MEMORY! 


Follow these instructions to warmstart the system: 


Mount a tape that begins with a bootstrap section on the tape unit. 
Close the tape unit door securely. 

Press the LOAD button twice. 

Press the ONL button once. 

When the READY light is on, turn the key to TEST. 

Enter <e>D to display the System Control Menu. 

When the prompt "ENTER OPTION (1-10) :" is displayed, enter "2" 
followed by the RETURN key. 

Enter "W" in response to the "OPTIONS" message. 


[ee] An SWD = 
. 


If the system encounters a buffer linkage problem while performing the 
warmstart, it notifies you with error messages and the prompt: 


ENTER F FOR FIRMWARE DEBUGGER OR RETURN TO CORRECT? 


Press the RETURN key to attempt to correct the problem. If the problem is not 
corrected, the above message is displayed again. If this occurs, you have two 
options: 1) contact you Microdata support representative if you have the time 
to research and solve the problem, or 2) perform a coldstart. 


When the warmstart is complete, all terminals should be operational at the 


point where they previously failed, Figure A illustrates a terminal display 
that has been interrupted, followed by a warmstart. 
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M/DICT. ccsccccccacees D/CODE E/ BASE os saosin oiew Fo / MOD awa es seas F/SEP 


DISC-ERRORS D 1031 3 1 
ERRMSG D 1035 

OPTIONS (W,X,A,F,AF,D) = 

127 IS THE SPUOLER’S LINE 

1024K OF MEMORY 

DRIVE DO, REFLEX-II 

DRIVE D1, REFLEX-II 

CONFIGURATION CORRECT? (Y/N)? 

DL/ID 
M/DICT 
MD 
STAT-FLILE 
ACC 
ACCOUNT 
CHANNEL 
PKOCLIB 


c 


374 
874 
942 
ACC 
ACC 
ACC 
PROCLIB 


D 
D 
D 
Q 
Q 
Q 
Q 


I 7.D9 


Note that a warmetart may cause some terminal 
characters to be dropped. 


Figure B. Example of LISTFILES Interrupted, Followed by Warmstart 
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4.10 Coldstart 


If a warmstart fails, or if any main memory module has been moved or replaced, 
it is necessary to perform a coldstart. Also, every complete (“AF”) system 


load begins with a coldstart. Ina coldstart, the following steps occur (see 
Figure A). 


1024 pytes are transferred to low main memory from tape. These 1024 
bytes include a program for Part 2. 


The configurator is loaded from tape. 
The configuration process is started. 
An initial set of virtual frames is read from tape. 


Control is given to Channel Zero which carries out other desired 
options (e.g., ABS load, file-restore). 


To perform a coldstart, follow these steps: 


1. 
2. 
3. 
4. 
5. 
6. 
7. 


8. 
9. 


10. 


ll. 


NOTE: 


60 


Mount tape beginning with a bootstrap section on the tape unit. 

Close tape unit door securely. 

Press LOAD button twice. 

Press ONL button once. 

When RDY light is on, turn key to TEST. 

Enter <c>D to display System Control Menu. 

To the prompt "ENTER OPTION (1-10) :", type in "2" followed by the 
RETURN key. 

Enter "X" in response to the "OPTIONS" message. 

To the question "“INITALIZE SPOOLER TABLES? (Y/N):", enter “N" to 
restart the spooler without losing print jobs. A "Y" reply also 
restarts the spooler but loses all print jobs, and the space associated 
with these print jobs is not returned to overflow. Also, the 
additional work space consumed by the processes logged on at the time 
of the coldstart is lost, and all lines are sent to logon. 


To the question “CONFIGURATION CORRECT? (Y/N):", enter "Y" if the 
configuration is correct; an "N" response redisplays the "OPTIONS" 
message. 


Enter the correct date and time. 

At this point, logon to the system and run the SYSTEM-SETUP PROC. 
A potential situation exists that may cause group format errors in files 
that had frames in main memory at the time of the coldstart. It is 


desirable to repeat an attempt at a warmstart several times before 
proceeding to a coldstart. 
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OPTIONS (W,X,A,F,AF,D) = % ~q——__—__- Coldstart 

127 IS THE SPOOLER“S LINE 

INITIALIZE SPOOLER TABLES? (Y/N) a 

1024K OF MEMORY : Configurator 

DRIVE DO, REFLEX-IIL 

DRIVE Dl, REFLEX-II 

CONFIGURATION CORRECT? (Y/N): 

SPOOLER STARTED «<—————-——______—___ Virtual process initializes 
software 

ENTER DATE. (MM/DD/YY)-.-11/10/82 <cr> 


ENTER TIME. (HH:MM:SS)...14:37:24 <er> 
14:37:24 10, NOV 1981 


CORRECT TIME AND DATE?(Y¥/N): 


ue 
= 
ae 


LOGON PLEASE: —q————————_————. Fine gero now avatlable 


Figure A. Example of a Coldstart Dialogue 
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4.11 ABS Loads 


This topic describes recovery procedures affecting portions of system software 


only. 


ABS LOADS 


It may sometimes be necessary to change or restore the virtual part of system 
software. This is done via an ABS load from tape. There are two ways to do 
this: 


1. Following a coldstart from tape. This is normal during a complete 
system load. It may also be necessary if a failure prevents operation 
of the system via TCL. This method is accomplished by responding with 
"A" to the prompt: 


OPTIONS (W,X,A,F,AF,D) = 


2. From TCL. (Use with CAUTION because data within frames is not 
initialized.) This is accomplished by mounting a tape which has the 
desired ABS section, attaching the tape unit spacing past the bootstrap 
section (I-FWD if the bootstrap section is present), and entering: 


In Case 1 above, all system software locks are initialized, the spooler is 
restarted, and all lines are sent to logon. 


In Case 2 above, locks are not reset, the spooler is not restarted, and no 
lines are sent to logon (see the :INIT-SYSTEM and :RESTART-SPOOLER verbs). 


In both cases, press RETURN in response to the prompt “OTHER OPTIONS?” 
(reserved for future enhancement). ABS frames are loaded from tape in the 
order in which they occur. The progress of the load is indicated by a sequence 
of one or more messages in the form: 

An-n (for a range of frames) 

Am (for individual frames) 
If a parity error is encountered during an ABS load, the prompt: 

PARITY ERROR! TYPE A (TRY AGAIN) OR TYPE LI (IGNORE)? 
appears (see Figure A). Entering "I" causes the ABS load to be accepted with 
the error. This should be used with caution because all aspects of the system 
May not operate properly after this has been done. It is not possible to 


identify the frame which contains the parity error other than to say that it is 
within the range of frames indicated by the current message (Am-n). 
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Another possible error is a checksum error. In this case, the following 
message appears: 


CHECKSUM ERROR FRAME = xx TYPE A (TRY AGAIN) OR TYPE I (IGNORE)? 
Entering "I" causes tne ABS load to be accepted with the error. 


Finally, the message: 
FORMAT ERROR IN ABS SECTION; TYPE A (TRY AGAIN) OR TYPE I (IGNORE)? 


may occur. This means that a format error was discovered on the tape. 
Possible causes are: 


1. Tape is not positioned at the start of an ABS section or the T-RDLBL was 
not used if initiated from TCL (wrong record size in effect). 


2. Tape has deteriorated or was misread in such a way that the format was 
unrecognizable. This may happen after entering "I" in response to the 
prompt following a parity error. 


Entering "I" in response to this prompt initiates a search for the next ABS 
frame segment on tape. If such a segment is found, the restore continues with 
the frame indicated. If no segment is found, the tape continues moving until 
it is stopped or an end-of-file is reached. 


The best way to recover from these situations is to use another tape to perform 
the ABS load, or if this is not feasible, it may be possible to MLOAD the 
necessary frames from the SYSTEM-OBJECT file. 


OPTIONS (W,X,A,F,AF,D) << —_-_____——. Coldstart, ABS restore 

127 IS THe SPOOLER“S LINE 

INITIALIZE SPOOLER TABLES? (Y/N) : 

1024K OF MEMORY Configurator 

DRIVE DO, REFLEX~-II 

DRIVE D1, REFLEX-IL 

CONFIGURATION CORRECT? (Y/N): 

OTHER OPTIONS? | 

TAPE SIZE CHANGED TO 08192 

Al 

PARITY ERROR! 

TYPE A (TRY AGAIN) OR TYPE I (IGNORE) : 

FORMAT ERROR IN ABS SECTION Caused by parity error 

ENTER A (TRY AGAIN) OR TYPE I (IGNORE 

-53 ~~ CTts indicates that frames 

A55-1215 , 1 - 68 were  toaded. 

SPOOLER STARTED | Frame 654 was ignored. 
. Frames 55 - 1215 were 


ENTER DATE. (MM/DD/YY).. 4 Loaded. 


ENTER TIME. (HH:MM:SS).. 
14:37:24 10 NOV 1982” 


CORRECT TIME AND DATE? (Y/N) 


LOGON PLEASE: 


Figure A. An ABS Load, Including Recovery from a Parity Error 
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4.12 System Configuration on System Upgrade 


If a system is changed to use a different number of ports, discs, or ABS 


frames, an “AF’ restore is mandatory. 


Because placement of the System Dictionary is set by hardware maximums for 
communication lines and ABS frames, a complete (‘AF’) restore from a file-save 
tape is needed when a system upgrade changes the configuration. 


Similarly, a complete (’AF’) restore is needed when a system is changed to run 
on a different combination of discs because the frame mapping onto the discs is 
altered. 


Only an “°X’ level coldstart is necessary when changing the amount of main 
memory a system uses. 
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(THIS PAGE INTENTIONALLY LEFT BLANK) 
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4.13 Formatted File-Restore 


File-restores cause files to be created, loaded, and integrated into the 
systems A file-restore of a complete system builds a system containing all the 
files and data of the source system. 


Sequence of Events in a Formatted File-Restore 


The first event in a complete formatted file-restore is initialization of 
available overflow space to the complete range on the system from the process 
work spaces forward to the end of disc. 


The System Dictionary is then created and cleared. The first account Master 
Dictionary is created and a pointer to it is placed in the System Dictionary. 
Then the first file dictionary is created and a pointer to it is placed in the 
account’s Master Dictionary. Next is the data file, which will proceed in one 
of two ways: 


1. The slow method. The file is created, a pointer is added to the 
dictionary, then the data is loaded. This method is necessary if 
reallocation is being performed, or if the file is a pointer file. 


2. The fast method. The file is loaded group by group as it is created. 
After it is completely loaded, a pointer is placed in the dictionary. 
This is the normal method. 


Next, the file dictionary is loaded. The next file’s dictionary and data 
sections are created and loaded, and so forth until all of the account’s files 
are present. Then the account dictionary is loaded. When the account is 
finished, a D-pointer to the account is placed in the System Dictionary. The 
file restore continues in the same manner for the next account (if any). 


Account-restores proceed in the same sequence, except that the System 
Dictionary is already present, and only the pointer to the account Master 
Dictionary is added to it. 


Console Listing Accompanying File-Restore 


Figure A is an example of a formatted file-restore listing. Each line 
corresponds to a file pointer and is indented in accordance with the level of 
the file in which the pointer is placed. The file-name is first, followed by 
the base, modulo, and separation of the file as it is being restored. An "(S)" 
following the line indicates that the pointer has the same base as some other 
pointer already listed and that file has already been created. 
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OPTIONS (W,X,A,F,AF,D) 
127 IS THE SPOOLER’S LINE 

1024K OF MEMORY 

DRIVE DO, REFLEX-II Configurator 
DRIVE Dl, REFLEX-I1 
CONFIGURATION CORRECT? (Y/N) +: 
OTHER OPTIONS? 


At Coldstart, files only restore 


TAPE SIZE CHANGED TO 08192 
SPOOLER STARTED 
ENTER DATE. (MM/DD/YY)... 


ENTER TIME. (HH:MM:SS).. 
10:05:00 17 JAN 1983 


CORRECT TIME AND DATE? (Y/N): 


SYSTEM 6U8U,11,1 
BLUCK-CONVERT 6091,7,1 ~<¢————e——————""—" BASE = 6091, MODULO = 7, 
DL/1D 6091,7,1 (S) SEPARATION = 1 
CHANNEL 6098,1,1 
DL/ID 6099,7,1 
DL/ID 6080,11,1 (S) 
PRUCLIB 6106,7,1 
DL/LID 6106,7,1 (8) 
POINTER-FILE 6113,5,1 
DL/ID 6113,5,1 (S) 
SYSPROG 6118, 69,1 <—— ne SYSPROG account found here. 
MD 6118,69,1 (S$) 
M/DICT 6118,69,1 (S) ——nnnnmm (5) indicates that this pointer 
DL/ID 6118,69,1 (8) has the same base as a pointer 
STAT~FILE 6187,1,1 restored prevtously. 
DL/ID 6188,87,1 
DISC~ERRORS 6275,3, 1 —<—————e DISC-ERRORS §=file on SYSPROG 


DL/ID 6278,1,1 Sn here. 
ERRMSG 6279,17,1 Data sectton of DISC=FERRORS 
DL/ID 6279,17,1 (S) found here. 


ACC 6098,1,1 (8) er ee 
SYSPROG's M/DICT restored here. 


LOGON PLEASE: OT Q-potnters in the SYSTEM 


diettonary restored here. 


Figure A. Sample Formatted File-Restore Listing 
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4.14 Error Recovery During File Loads 


If parity errors or other errors mar the files section of a formatted file~save 
tape, some data may be lost. The restore will continue, but operator 


assistance may be needed. 


Parity Error Recovery Procedure 


If a parity error is detected on a formatted file-restore, the prompt 


PARITY ERROR! 
TYPE A (TRY AGAIN) OR TYPE I (IGNORE) 


is printed (see Figure A). Entering “I” causes the data block to be accepted 
as is from tape without data correction. The specific item affected cannot be 
determined. The file is the one whose name was last displayed on the terminal 
controlling the restore. 


Recovery From Destroyed Pointers 


If tape information identifying a file is destroyed, it may be impossible for 
the restore to create that file and subsequent files in the right order. The 
message 


“ERROR IN D=-SEGMENT 
@xxxXXxxX 
LEVEL (1-3)?’ 


is printed. "xxxxxxxx'" describes the software location where the error was 
detected. You must advise the restore processor whether to search for and 
continue with the next account (response = 1), the next dictionary (response = 
2), or data file (response = 3). The response requires your judgment as to the 
positioning of files on the tape and the total situation. 


Tape Format Errors 


If a segment of the file-save tape cannot be recognized, a tape format error 
occurs and the following message is displayed: 


TAPE FORMAT ERROR @xxxxxxxx SEGMENT SKIPPED 
The segment is skipped and the restore continues with the next segment (see the 
topics FILE-SAVE TAPES: FORMAT and TAPE SEGMENTS IN FORMATTED FILE-SAVE in 
Chapter 11); the beginning of the segment skipped will be displayed. 


A common cause of these errors is’ improper positioning of the tape or failure 
to use T-RDLBL if initiating the restore from TCL. 
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OPTIONS (W,X,A,F,AF,D) =¥ «————__—_____ Coldstart, files only restore 
127 IS THE SPOOLER“S LINE 

1024K OF MEMORY 

DRIVE DO, REFLEX-I1 Configurator 

DRIVE Dl, REFLEX~LI 
CONFIGURATION CORRECT? (Y/N) 
OTHER OPTIONS? 


TAPE SIZE CHANGED TO 08192 
SPOOLER STARTED 


ENTER DATE. (MM/DD/YY).. 


ENTER TIME. (HH:MM:SS). 
10:10:00 17 JAN 1983 


CORRECT TIME AND DATE? (Y/N 


SYSTEM 4224,11,1 
BLOGK-CONVERT 4235,7,1 
DL/ID 4235,7,1 (S$) 


PARITY ERROR! ENTER A TO TRY AGAIN, I TO IGNORE? The the nausea 


one or more 
bytes to be 
incorrect. 


TAPE FORMAT ERROR @0OD00104 SEGMENT SKIPPED 
OO3AP712*C11°1 


CHANNEL 4242,1,1 The start of the skipped ttem 
DL/ID 4243,7,1 a ol looked like thie 

DL/ID 4224,11,1 (8) 

PROCLIB 4250,7,1 The restore continued 

DL/ID 4250,7,1 (8) 


POINTER-FILE 4257,5,1 
DL/ID 4257,5,1 (S) 
SYSTEM 4224,11,1 (8) 
SYSPROG 4262,69,1 (8) 
MD 4262,69,1 (S) 
M/DICT 4262,69,1 (3) 
DL/ID 4262,69,1 (S) 
STAT-FLLE 4331,1,1 
DL/ID 4332,87,1 
DISC-ERRORS 4419,3,1 
DL/ID 4422,1,1 


LOGON PLEASE: 


Figure A. Recovery from Parity Error in Formatted File-Restore 


83-1109 69 


5 TERMINAL CONTROL LANGUAGE 


5-1 Overview 


The Terminal Control Language (TCL) is the primary interface between you and 


various SEQUEL processors. 


Most processors are activated directly from TCL by a single input statement, 
and return to TCL after completion of processing. Some processors (the EDITOR 
for example) retain control of the terminal until explicitly exited, at which 
point they return control to TCL. TCL prompts you by displaying a colon (:). 
This is referred to as the "TCL prompt character". Input statements are 
constructed by typing one character at a time on the terminal until the 
carriage return or line feed key is pressed, at which time the entire line is 
processed by TCL. 


TCL expects the first word of an input statement to be a "verb". There are 
three types of verbs in SEQUEL: 


. ENGLISH verbs 
. TCL-I verbs 
. TCL-II verbs 


One of SEQUEL’s powerful features is your ability to customize each user’s 
vocabulary. Since verbs reside in each user’s Master Dictionary (M/DICT), the 
vocabulary may be added to or deleted from without affecting the other users. 
In addition, an unlimited number of synonynis may be created for each verb. 


Figure A presents an overall view of the intraprocessor linkages within the 


SEQUEL system. This figure illustrates the flow of control between TCL and 
various SEQUEL processors. 
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FROM 
COLD-S TART 


PROC LOGOFF 
PROCESSOR PROCESSOR 


PROCESS 
INITIALIZATION 


TCL-I 
PROCESSOR 


LOGON 
PROCESSOR 
TCL-L VERBS 
(TIME, DUMP, ETC.) 


LOGON 


TCL-II VERBS 
(EDIT, COPY, ETC.) 


ENGLISH VERBS 
(LIST, SORT, ETC.) 


FROM ANY 
PROCESSOR 


TCL-II PRE 
PROCESSOR 


DEBUG 
PROCESSOR 


ENGLISH 
PREPROCESSOR 


ENGLISH 
SELECTION 
PROCESSOR 


WRAPUP PROCESSOR 


*TCL=I processors 
**TCL-II processor 
**KENGLISH processors 


Figure A. Overall View of SEQUEL Intraprocessor Linkages 
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5.2 Input Statements 


TCL operates on one input statement at a time. An input statement must begin 


with a verb, and may be comprised of multiple lines. 


The system normally operates in the "full-duplex" mode of communication with 
each terminal. "Full-duplex™ means that data is being transmitted between the 
terminal and the computer in both directions simultaneously. The system also 
operates in what is known as an "Echo-Plex" environment. This means that each 
data character input by the terminal is echoed back to the terminal by the 
computer. Thus, the character displayed on the screen is the same as the 
character stored in the computer. It is possible to stop terminal echo by 
using the HUSH verb. Terminal is restored with the NOHUSH verb. 


TCL handles only complete input lines. When you compose an input statement, 
no action is taken until TCL detects a carriage return character. If a 
carriage return is not detected, data characters are assembled in your input 
buffer until 140 characters have been entered, and TCL automatically generates 
a carriage return. 


In addition to the standard ASCII character set recognized by TCL (refer to 
the Appendix), special operations are performed when control characters are 
detected. The control characters listed in Figure A perform editing 
functions. All other control characters are deleted from the input line that 
is passed to lower procedures, but remain in the original input line. Control 
characters are represented in this manual by preceding the character with the 
symbol <c>. This means that the <CONTROL> or <CTRL> key must be pressed while 
typing the desired character. The <SHIFT> key may also have to be pressed 
simultaneously if the desired character appears on the upper half of a key. 
TCL analyzes your input statement and copies the statement into a buffer. It 
also performs the following tasks: 


The first word of the sentence is assumed to be a verb and is looked up in 
your Master Dietionary (M/DICT), but is not copied. 


Redundant blanks surrounding all words in the statement are deleted. 


Character strings surrounded by single quotes (') or double quotes (") are 
identified and copied verbatim, including redundant blanks. 


Figure B defines the options that may be used with TCL-I and TCL-II verbs, 


Unless defeated with an "N" option (see-Figure B), all listings to the 
terminal will pause at the end of each screen and wait for a keystroke before 
continuing with the next screen. The control characters <c>E and <e>S have 
special meanings if input at this pause: 


<e>E The listing will be terminated and control returned to PROC or 


TCL. BASIC will respond to this control character if a heading 
or footing is enabled. 
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<a>Ss The <e>S is echoed and entry of another character is required 
before the listing will continue. This allows the soreen=-dump 
facility of certain terminals to be used to reproduce selected 
pages on a slave printer, 


CONTRO RACTER FUNCTION 
<e>H Backspace. Deletes last character typed in 
and allows you to re-enter character. 


<eok Cancel, Deletes the entire line currently 
being typed in. 


<o>R Retype. Causes entire line currently being 
typed in to be retyped. 


<o>_ Line Continuation. If typed as the last 


character in a line, will allow continuation 
of the line onto the next physical line, 
This character must be immediately followed 
by a carriage return or line feed. 


The listing will be terminated and control 
returned to PROC or TCL. BASIC will respond 
to this control character if a heading or 
footing is enabled. 


The <ce>S is echoed and entry of another 
character is required before the listing 
will continue, 


Figure A, Special Control Characters 


Inhibit automatic pause for carriage-return 
at end of page (NOPAGE), 


List item-ids while performing copy, dump, 
ete. 


Produce output on printer (spooler). 


Figure B, TCL=I Option Specifications 
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5.3 Verb Definition Items in M/DICT 


Each TCL-I, TCL-II, or ENGLISH verb is defined as an item in your Master 


Dictionary (M/DICT). 


Each verb definition resides as an item in your M/DICT. The item-id of a verb 
definition item is the verb name itself. The attributes used in a verb 
definition item are defined in Figure A. 


As an example of a verb definition item, the following item (stored as item 
‘LIST’ in your M/DICT) defines the ENGLISH verb LIST: 


Item ’LIST’ in M/DICT 


001 PA 
002 35 
003 4D 


The following verb definition item defines the TCL-II verb MLIST: 
Item ’MLIST’ in M/DICT 


001 PY 
002 2 
003 20 
004 
005 CU 


As a final example, the following verb definition ttem defines the TCL-I verb 
TIME: 


Item “TIME” in M/DICT 


001 PZ 
002 3033 


You may create any number of synonyms for verb definition items (and may even 
remove the predefined verb definition items), thereby creating your own 
vocabulary. Synonyms may be created by copying the verb definition item into 
another M/DICT item with the desired synonym name as the item-id. 
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ATTRIBUTE NUMBER DESCRIPTION 


Q ~—___———-_ This is the item-id, which is the name of the 


verb 


Must contain: 
Pe 
P identifies the M/DICT item as a verb 
definition item. The single character ec is 
passed to the defined processor. (Note: If 
c is "Q", the item is a PROC, not a verb; in 
this case, the "Q" may be followed by an "N". 
Refer to the PROC Manual for further 
information.) 


This attribute defines the processor entry 
point to which TCL passes control (i.e., the 
mode~id in hex). An ENGLISH verb will have 
an entry of: 


35 

A TCL-II verb will have an entry of: 
2 

A TCL-I verb will have an entry of: 
XXXK 


where xxxx is the entry point 


Secondary transfer point. Use depends on 
Attributes 1 and 2 


Tertiary transfer point. Use depends on 
Attributes 1 and 2 


TCL-II parameter string. These parameters 
govern treatment of the items retrieved by 
TCL-II verbs to be passed to the processor 
whose entry point is defined in Attribute 3. 
Parameter may be any of the following: 
C - Copy item to a work area 
E - Blanks are compressed on file, 
expanded for processing 
F - Pick up file parameters only 
(ignore item-list) 
N - Okay if item is not on file 
P - Print item-id if multiple items are 


specified 
U - Items will be updated by processor 
Z - Final entry required after 


processing last item 


Figure A. Verb Definition Item in M/DICT 
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5.4 TCL=-II Input Statements 


The format of a TCL=II input statement is more restrictive than that of an 


ENGLISH statement (refer to the ENGLISH Programming Manual). This enhances 
processing speed, as statement parsing is quicker. 


Selection-criteria and output-specifications are not allowed in TCL-II 
statements. The file-name (or DICT file-name) must immediately follow the 
TCL-II verb. Item selection is more restricted, since each item=-id must be 
explicitly named in the statement, although all items may be specified by the 
use of an asterisk (*). 


Figure A illustrates the general form of a TCL-II statement. The file-name 
specifies the desired file. The DICT option specifies the dictionary portion 
of the file. The item-list is made up of one or more item-ids, separated by 
blanks. It an item-id contains embedded blanks or parentheses, it must be 
surrounded by single quotes. All items in a file may be specified by entering 
asterisk (*) as the item-list. Options, if specified, must be enclosed in 
parentheses at the end of the input line. Multiple options may be separated 
by commas. The specified options are passed to the appropriate TCL-II 
processor. Figure B illustrates a sample TCL-II input statement. 


Some TCL=II verbs are listed in Figure C. For further information, refer to 
the following sections of this manual: 


FILE MANAGEMENT PROCESSORS 
MAGNETIC TAPE UNIT VERBS 
SPECIAL SYSTEM UTILITIES 
SYSTEM MAINTENANCE PROCEDURES 


Also, refer to the following manuals: 


ENGLISH Programming Manual 

SEQUEL Assembly Language Programming Manual 
DATA/BASIC Programming Manual 

PROC Programming Manual 

EDITOR Programming Manual 


verb {DICT} file-name item-list { (options) } 


specifies || specifies || spectftes|| 8 Lft spectfies appli- 
operatton || dicttonary|| file cable opttone 


Figure A, General Form of TCL-II Input Statement 


16 (REV 6/84) 83-1109 


5 TERMINAL CONTROL LANGUAGE 


‘EDIT FNA TEST (Z) _<cr> 


Figure B. Sample TCL-II Input Statement 


DESCRIPTION 
Inhtbit automatte pause for <er> at end of page (NOPAGE). 
List ttem-ids while performing COPY, DUMP, ete. 


Produce .output on printer (spooler). 


Figure C. Sample TCL-II Option Specifications 


VEKB DESCRIPTION 
COLDDUMP Create coldstart (bootstrap) tape. 
COPY Copy data files and dicttonartes. 
EBASIC Compile compressed DATA/BASIC program. 
ECOPY Hupand compressed items. 

EED Edit compressed iteme. 


FIX-FILE-ERRORS Repair group format errors. 


GROUP List file usage statieties for an entire file. 


ITEM List usage statistics for a single item. 
MEM-DIAG Start memory dtagnostte. 


SAVE Backup system. 


Figure D. Some TCL-II Verbs Described in This Manual 
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5.5 TCL-I Input Statements 


Verbs which have a code other than "2" or "35" in Attribute 2 of their 
respective M/DICT verb definition items are called TCL~I verbs. TCL-I verbs 


are used to form TCL-I input statements. They may have an option specification 
of the form: (options). 


A TCL-I input statement must begin with a TCL-I verb and end with a carriage 
return. Some TCL-I verbs additionally allow for various parameter 
specifications. TCL-I verbs are listed in Figure A. For further information 
regarding these verbs, refer to the following sections in this manual: 


. LOGON/ LOGOFF 

‘ FILE MANAGEMENT PROCESSORS 

. SPOOLER ; 

. MAGNETIC TAPE UNIT VERBS 

. SPECIAL SYSTEM UTILITIES 

. SYSTEM MAINTENANCE PROCEDURES 


VERB DESCRIPTION 
: ABSLOAD Loads executable assembly code (ABS) from 

>; ABS/ FILES Loads ABS and files from tape. 

> FILES Restores files from tape. 

: INIT-SYS TEM Lnitialtazes system locks. 

: RESTART~SPOOLER Restarte spooler process. 

ACCOUNT-RESTORE Restores user account from tape. 

ADDD, ADDX Adde decimal or hexadectmal numbere. 
BLOCK-PRINT Sends block characters to printer. 

BLOCK~TERM sends block characters to terminal. 

BUFFERS Displays status/content of memory buffere. 
CHARGE-TO Keeps track of computer usage. 

CHARGES Prints current computer usage. 

CLAIM keturne Linked overflow to contiguous overflow. 
CLEAR-BASIC-LOCKS Resets execution locks (0-63). 

CLEAR“FILE Removes all file items froma file or dictionary. 
CREATE-F ILE Creates a new file. ; 

DE-RESET Resets dise error recording table. 

DE-START Starts disc error recording. 

DE-STOP Stops diee error recording. 

DELETE-FILE Deletes an entire file. 

DISCLO Produces dise activity report. 

DIVD, DIVX Divides decimal or hexadectmal numbers. 

DIX Converte decimal number to hexadecimal. 

DUMP Dumps virtual frames to terminal. 


Figure A. Some TCL-I Verbs Described in This Manual 
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VERB 


HUSH 
LIST-LOCKS 
LOGTO 
MESSAGE 
MSG 

MULD, MULX 
NOHUSH 

OFF 

P 

P-ATT 
P-DET 

POVE 
SET-DATE 
SET-TERM 
SET-TIME 
SLEEP 
SP-ASSIGN 


SP-CHECKY 
SP~EDIT 
SP-EJECT 
SP-KILL 
SP-RESUME 
SP-SKIP 
SP-STATUS 
SP-STOP 
SP-TAPEOUT 
SUBD, SUBX 
T-ATT 
T-BCK 
T-CHK 
T-DET 
T-FWD 
T-RDLBL 
T-READ 
T-REW 
T-WEOF 
TERM 

TIME 

USER 
WHAT 
WHERE 

WHO 


XTD 
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DESCRIPTION 


"Hushes" terminal echo. 
Displays group locks. 

Switches to another user account. 
Communteates to other users. 
Same as MESSAGE. 

Multipltes decimal or hexadecimal numbere. 

Restores terminal echo. 

Terminates user's session. 

Toggles printing at terminal on and off. 

Attaches line printer. 

Detaches line printer. 

Prints available overflow report. 

Sets system date. 

Sets terminal/printer charactertstics for all lines. 
Sets system time. 

Sets a process into quiescent state for specified time. 
Assigne print job(s) to form queue and assigns option(s) 
to print job(s). 

Counts number of hold files. 

Examines closed print jobs. 

Ejects Line printer pages. 

Cancels current spooler output on designated device. 
Recovers from spooler halts. 

Sets number of form feede. 

Displays statue of spooler form queues. 

Halts spooler after current print job. 

Printe tape file on line printer. 

Subtracte decimal or hexadecimal numbere. 

Attaches magnetic tape untt. 

Backspaces tape. 

Checks tape for parity errors. 

Detaches magnette tape unit. 

Forward-spaces tape. 

Reads tape label. 

Reade one record from tape. 

fewinds magnetie tape. 

Writes EOF on tape. 

Sets terminal characteristice. 

Prints time and date. 

Displays privilege level and workspace assignment. 
Displays current system parametere. 

Shows user points of executton. 

Prints the line number and aecount name to whieh the 
terminal is logged on. 

Converts hexadecimal number to decimal. 


Figure A. Some TCL-I Verbs Described in This Manual (Continued) 
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5.6 Program Interruption (Debug Facility) 


Processing can be interrupted by pressing the <BREAK> key on the terminal. 
This causes an interrupt in current processing and an entry into the DEBUG 


state. However, such an interruption is inhibited during critical stages of 
processing. 


When the <BREAK> key has been pressed and the DEBUG state has been entered, the 
following message is displayed: 


I xed 
! 


where "x" and "d" describe the software location of the interruption (refer to 
the DEBUG documentation in the SEQUEL Assembly Language Programming Manual). 
The DEBUG prompt character (!) prompts you for a DEBUG command. For users with 
system privilege levels zero or one, the commands listed in Figure A are the 
only DEBUG commands allowed. Users with system privilege level two should 
refer to the SEQUEL Assembly Language Programming Manual for further DEBUG 
facilities. 


Figure Bb illustrates a sample terminal interaction with the DEBUG facilities. 


Note that pressing the <BREAK> key while in the terminal input or output mode 
causes a loss of an entire line of characters. If in the input mode, the 
retype-line character (<c>R) should be used to check the loss of data after 
returning from DEBUG via the “G” command. 


Upon encountering one of the hardware abnormal conditions, the system 
automatically traps to the DEBUG state with a message indicating the nature and 
location of the abort. If you have system privileges level zero or one, you 
must type "END" or "OFF" to exit from the DEBUG state. Hardware abnormal 
conditions are described in the DEBUG section of the SEQUEL Assembly Language 
Programming Manual. 


When either "END" or “OFF" is entered while in the DEBUG state, the locks set 


by that process are unlocked. These locks include execution locks (0-63), and 
group locks. 
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DESCRIPTION 


Print on/off. Each entry of a "P" command switches 
(toggles) from print suppression to print 
nonsuppresston. The message OFF te displayed if 
output ts currently suppressed. The message ON te 
displayed if output ts resumed. This feature is 
useful when debugging. 


i ~——_—_--—___———- Toggles terminal echo off and on. 


G or <lf> ~~ case resumption of process execution from the 
potnt of interruption. "G" e@annot be ueedif a 
process ABORT condition caused the entry to DEBUG. 

END <cr> Terminates current process and causes an immediate 

return to TCL. 

END <1£> —¢——————_ perminates eurrent processing, but if a DATA/BASIC 

program was executing, control will pass to next 

statement in a PROC, tf executing within a PROC. 


Terminates current process and causes you to be 
Logged off the system. 


Figure A. DEBUG Commands for Users with System Privilege Levels Zero or One 


ENGLISH LIST statement 
STAFF. ccee CLDY wsaesee ote lore a0 ele 


1432 TALIAS 

2391 PHILADELPHIA ~+——-——  <BREAK> key pressed. 

I 6.143 <——————_____________. Interrupts message. 
Turne Print off. 
Resumes executton without printing. 
<BREAK> key pressed,. interrupte message. 
Turns Print back on. 
Resumes executton with printing. 


3051 NEW YORK 

4260 CHICA GO 

3913 MIAMI ~——_________- <BREAK> key pressed. 

I 6137<——_____________—_—_ Interrupts message. 
Terminates LIST executton. 


Listing output resumes. 


2951 LOS ANGELES 


TCL prompt. 


Figure B. Sample Use of DEBUG Facilities 
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6.1 Logging On and Off the System 


The logon processor initiates your session by identifying valid users and their 
associated passwords. The logoff processor terminates the session and should 


always be evoked via the verb OFF. These processors can accumulate accounting 
statistics for billing purposes and also associates you with your privileges 
and security codes. 


Logging On to the System 


You may log on to the SEQUEL system when the following (or a user-created) 
message is displayed: 


LOGON PLEASE: 


You then enter the user-id of the account established for you in the System 
Dictionary. If a password has also been established, you may follow your 
identification with a comma, and then the password; otherwise, if the 
specified account requires a password, the system will display the message: 


PASSWORD: Entered password is not echoed. 


The “hushed" area allows you to enter your password and not have it observable. 
SEQUEL validates your identification against the entries in the System 
Dictionary; if it is illegal, the following message is returned: 


USER-ID? 
LOGON PLEASE: 


You must then reenter your identification and password. If your identification 
is valid, but the password is not acceptable, the following message is 
displayed: 


PASSWORD? 
LOGON PLEASE: 


You must then reenter your identification and password. If you have 
successfully logged on to the system (i.e., both the identification and the 
password have been accepted), the following message (#335) is displayed: 


ARK WELCOME TO MICRODATA SEQUEL RK 
RRR time RELEASE x.y date *** 


where “time” is the current time, "date" is the current date, and “x.y” is the 
current SEQUEL release level. Figure A illustrates a sample logon interaction 
where the valid identification is TEST and the valid password is XYZ. 
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Logging Off the System 


Logoff is achieved by entering the word OFF, either at the TCL level or at the 
DEBUG level. A message indicating the connect time (i.e., number of minutes 
you were logged on) and the appropriate charge units will be displayed. The 
system then displays the LOGON PLEASE message and waits for the next session to 
be initiated. The general form of the logoff message is: 


RRKKEREKAKKRKKERRRKEKEE RE REREREEKER RRR RRERREKRERERRERER 


RRR CONNECT TIME AT 14:38:19 = 1533 MINUTES aK 
xkK 6 CPU MS. «== 253 DISC READS = 443 aaR 
RAK NUMBER OF ACTIVATIONS = 785 RRR 


KREKKKEKAAKRKEAKRERE ERE RERKRRERRERERERERRRERREERRRRERRERE 


Figures A illustrates sample logon interaction. Figure B illustrates a sample 
logoff interaction. 


LOGON PLEASE 


USER-ID? 


LOGON PLE 
PASSWORD: 


RRK WELCOME TO MICRODATA SEQUEL 
aK 14:07:00 RELEASE 1.1 15 FEB 1983 
ReK MICROATA SYSTEM SOFTWARE 

RAK 8820001920 REV 8 

KKK CONSISTING OF 

KEK PM20001921 REV B (SYS-GEN) 


FIGURE A.» SAMPLE LOGON INTERACTION 


REEKEKKRRKEKERERKERERERREERRERERERRERERRRERERKERRERERRERE 


KKK CONNECT TIME AT 15:50:00 = 3 MINUTES RK 
ARK CPU MS. = 253 DISC READS = 443 RRR 


RRR NUMBER OF ACTIVATIONS = 785 ea 
KAREKAERKRARKEE KER ERE RRERAER REE REE ERE RR ER ERR ERERERERRK 


x** = =LOGGED OFF AT 15:50:33 ON 15 FEB 1983 wk: 


LOGON PLEASE: 


Figure Bb. Sample Logoff Interaction 
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6.2 System Message Formats: Logon Message 


Messages in the ERRMSG file have a defined format. The item “LOGON” in the 


SYSTEM Dictionary is a prompt message for logging on to the system. 


The ERRMSG file contains items which format system messages. This file is 
improperly called the Error Message File. SEQUEL software uses items in this 
file to print most of the messages associated with the various processors (see 
the Appendix). The codes that may be present in one of these items are: 


A{(n)} Parameter insertion code. The next parameter passed to 
the system message print routine is inserted at this 
point in the message. If "n" is specified, the 
parameter is left-justified in a field of “n”" blanks. 


D Adds system date in the format DD MMM YYYY. 


E{char-string} The message item-id, surrounded by brackets, is printed 
followed by the optional character string. 


H{char-string } The character string is printed. If the string is to be 
a prompt, a plus sign (+) may be added to hold the 
cursor on the current line. 


Li{(n)} The specified number of line feeds are output (one if 


n” not specified). 


R{(n)}} As in "A" above, except the parameter is right-justified 


in a field of "n" blanks. 


s{(n)} The specified number of spaces (counting from the 
beginning of the line, not from current position) is 
skipped. If the end of the line is reached, the line is 
printed and a new line is started. 


T Adds system time in the format HH:MM;SS. 

Xx Skips the next parameter. 
The item called “LOGON” in the System Dictionary follows this format. This 
message is the prompt invitation to log on to the system. Figure A displays a 
sample logon item in the System Dictionary. Figure B lists error message 335; 
you see this message immediately after logging on to the system. 
WARNING: Items in the System Dictionary must not be altered while other users 


are logged on because the position of items might change, 
invalidating critical pointers. 
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LOGON 
OOL L(2) 
002 T 

003 8(21) 


OU4 D 
005 L 
006 HLOGON TO THE DEVELOPMENT SYSTEM: + 


Figure A. Sample Alternate Logon Message in System Dictionary 


*x** = =WELCOME TO MICRODATA SEQUEL 


H ARE 

T 

5(20) 

HRELEASE 1.1 

$(35) 

aKa 

RAK MICRODATA SYSTEM SOFTWARE 
ARK $S20001920 REV B 

aK CONSISTING OF 


we PM20001921 REV B (SYS-GEN) 


D 
H 
L 
H 
4 
H 
5 L 
H 
L 
H 
L 


Figure B. Listing of ERRMSG 335 
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6.3 Logon PROC and General System Messages 


Upon logon, SEQUEL allows for the execution of a PROC with an item-id identical 


to your identification. SEQUEL also allows a general message to be sent to all 
users as they log on to the system. 


The Logon PROC 


When you have logged on to your account, SEQUEL permits the automatic execution 
of a PROC whose item-id is the same as your identification. That is, the 
Master Dictionary of the account is checked for a PROC matching the 
identification which was used to log onto the account; if found, it is 
executed. (For information regarding PROCs, refer to the MICRODATA PROC 
Programming Manual.) 


Typically, the Logon PROC performs standard functions always associated with 
your particular needs. For example, assume that the PROC listed in Figure A 
(which includes a TERM operation) is stored as item TEST in your Master 
Dictionary (M/DICT). If your identification is the word TEST, then the TEST 
PROC is executed automatically every time you log on (i-e-, your particular 
terminal characteristics are automatically set). This is illustrated in Figure 
Be 


General System Message 


SEQUEL allows you to send the same message to all users as they log onto the 
system. The item “LOGON” in the ERRMSG file may define such a message which is 
typically used to transmit information pertaining to system up-time, and the 
like. It should be noted that the LOGON message item must be present in the 
ERRMSG file even if no general system message is to be sent; in this case, the 
item should have no attribute values (i.e., an item-id only). The format of 
the LOGON message item is the same as any other message item in the ERRMSG file 
(see the topic SYSTEM MESSAGE FORMATS in this chapter). 
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Item “TEST” in M/DICT 


QOL PQN 

002 HTERM 118,44,7,6 

v03 P 

04 X*** TERMINAL CHARACTERISTICS SET *** 


Figure A. Sample Logon PROC 


LOGON PLEASE: TEST,XYZ <cer> <—————_____—_. Logon sequence. 


RRR WELCOME TO MICKODATA SEQUEL RR 
**k* = 617:09:50 RELEASE 1.1 15 FEB 1983 aw 


kk: 


TERMINAL CHARACTERISTICS SET *44 + Message from TEST PROC. 


SS SSS ae rome chara 


ter. 


Figure B. Automatic Execution of Sample PRUC from Figure A 
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6-4 Computer Usage: CHARGES and CHARGE-TO Verbs 


The CHARGES verb prints the current computer usage since logon. The CHARGE-TO 


verb charges the current computer usage since logon to a specified project or 
accounte 


CHARGES Verb 

The CHARGES verb displays the current computer usage since logon as connect 

time in minutes, CPU milliseconds, the number of disc reads, and the number of 

process activations (number of timeslices). The general form of the verb is: 
CHARGES 

CHARGE-TO Verb 


The CHARGE-TO verb keeps track of computer usage for several projects 
associated with the same LOGON name. The general form of the verb is: 


CHARGE-TO account~name 
This verb performs the following functions: 
1. Terminates the current charge session by updating the Accounting 
History File with the appropriate connect time in minutes, CPU 


milliseconds, and the number of disc reads. 


2. Changes the logon name in the Accounting History File to the original 
name concatenated with an asterisk and the name following CHARGE-TO. 


For example, if you are currently logged on to SYSPROG, and you type in: 


Sees 


the LOGON name in the Accounting History File will be changed to 
"SYSPROG*PROJECT1". 


Figure A shows the general form of the CHARGES and CHARGE-TO verbs. Figure B 
shows examples of the verbs. 
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CHARGES ~—-____________ Displays current computer usage. 


CHARGE-TO account-name~——___. Charges current computer usage to a 
project. 


Figure A. General Form of CHARGES and CHARGE-TO Verbs 


KRKKRRERARR RRR RRR ERE ER ER RRR RRRRERERRRER RR RN ARR I 
KKK CONNECT TIME AT 14:38:19 = 33 MINUTES badd 
**e* = =©6 CPU MS. = 253 DISC READS = 443 akR 


RRK NUMBER OF ACTIVATIONS = 173 nee 
KHRKKARREREK RRR AKA KRRERAKRR REE RR ERR ERE RRR RERRAE 


RRRAEKK KKK KK RERRERRRER ERE RRR EERE RRR ERERERERRARR RRR 
KKK CONNECT TIME AT 14:39:41 = 34 MINUTES RRR 
**kk = =©6CPU MS. = 261 DISC READS = 449 blak 


wRK NUMBER OF ACTIVATIONS = 197 ak: 
HARKKRKKRKAKRKKRERE KR RRRRRERRRRKRRRRERERERRERRERIRRR RRR 


Figure B. Examples of CHARGES and CHARGE-TO Verbs 
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6.5 LOGTO Verb 


The LOGTO verb allows you to log to another account without first having to log 


off. The work space assigned to the original account is retained. 


The general form of the verb is: 
LOGTO account-name{, password} 


where “account-name" is the account to log to. After entering the LOGTO 
command, the following occurs: 


l. The system checks to see if the specified account is appropriately 
defined in the System Dictionary. 


Ze If you did not enter a password and one is required, you are then 
prompted for the passwword. 


3. The accounting statistics are updated if being kept for the present 
account. 
4. The security codes and system privilege level are changed to those 


of the new account. 


5. The work space assignment of the original account is retained. 
6. The spooler assignment and device attachment are retained. 
7. If found, the Logon PROC is executed. 


The LOGTO verb must not be executed from a PROC. Figure A shows the form of 


the LOGTO verb. Figure B shows an example of the LOGTO verb. 
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LOGTO account-name{ ,password} 


Figure Ae General Form of LOGTO Verb 


KKK KARE RRRERKRREKERRERERRERERERER RRR ERR RRERERERRRERE 
aRK CONNECT TIME AT 14:38:19 = 1533 MINUTES %*** 


RX =©6CPU MS. = 253 DISC READS = 443 RK 


RAK NUMBER OF ACTIVATIONS = 785 bakakal 
HKAKKKARK RARER ERE RRR ERERERERERERERERRERERERERERRERK 


Figure B. Sample Usage of LOGTO Verb 
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6.6 User Identification Items 


Each user has a user identification item stored in the System Dictionary. 


These items define users who can log on to the system. User identification 
items are either file definition items or file synonym definition items. 


User identification items are initially created via the CREATE-ACCOUNT PROC 
(see Chapter 11, SYSTEM MAINTENANCE PROCEDURES). These items may subsequently 
be updated via the EDITOR (see the Microdata EDITOR Programming Manual). 
Entries in the System Dictionary should only be updated (from the SYSPROG 
account) when no other users are logged on to the system. This is because the 
system software maintains pointers to data in the System Dictionary when users 
log on, and updating the System bictionary will invalidate the pointers. An 
exception to this rule is when creating a new account (or a synonym to an 
existing account), which can be done at any time since new items are added to 
the end of the existing System Dictionary data, and thus do not disturb any 
existing items. 


User Identification Attributes 


Attributes 5 through 8 of a user identification item contain data associated 
witn a user’s security (lock) codes, password, and privileges: 

Attribute 5: Contains the set of retrieval lock-codes associated with a 
user. Multiple values (separated by value marks) are 
allowable. There is no restriction on the format of 
individual lock-codes. This attribute may be null, 
indicating no lock-codes. (Lock-code usage is described in 
the topic SECURITY in this chapter.) 


Attribute 6: Contains the set of update lock-codes associated with a user 
(same as described for retrieval lock-codes above). 


Attribute 7: Contains a user’s password, which is a single value. This 
attribute may be null. There is no restriction as to the 
format of the password. 


Attribute 8: Contains a code which indicates the level of "system 
privileges" and work space assigned to a user. Three levels 
of system privileges are available: they are referred to as 
zero (lowest), one, and two (highest). Lower levels of 
system privileges restrict usage of certain facilities of 
the system, as described in Figure B. SYSO designates. Level 
0, SYSL designates Level 1 and SYS2 designates Level 2. The 
system privilege code may be immediately followed by an 
“additional work space" parameter enclosed in parentheses 
(see the topic, WORK SPACE ASSIGNMENT in this chapter). 
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Attribute 9: May contain the code "U" to indicate that logon/logoff times 
should be collected in ACC file by the system. 


Attributes 1 through 4 and Attribute 13 are as defined for regular file 
definition items (see the topic FILE DEFINITION ITEMS in Chapter 3). Figure A 
shows a sample user identification item (for user XYZ). 


Item XYZ in System Dictionary 


0 ———— SS 00D 
002 2537 Base FID 
003 13. odulo 
004 LA senaration 
005 ABC —q————_—__—_________. Retrieval Lock Code (L/RET) 
006 1234—————--____—___—____. Update Loek Code (L/UPD) 
007 PWS ~————_—_—————-. Password 
008 SYS2(25) 
{ A eon Work Space Assignment 
- System Privilege Level 
009 U ~—_—___—----__——————- Update ACCOUNT File for this user 


Figure A. Sample User Identification Item (For User XYZ) 


FACILITY LOWEST PRIVILEGE LEVEL REQUIRED 


Updating of M/DICT 
Use of magnetic tape 


Use of DEBUG (other than P, 
OFF, END and G commands) 


Use of DUMP processor 


Use of assembler and loader 


Use of FILE-SAVE and 
-FILE-RESTORE processors 


Figure B. Required System Privilege Levels 
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6.7 Work Space Assignment 


Additional work space may be specified immediately following the system 


privilege code in Attribute 8 of the user identification item. 


There are three "linked" work spaces symbolically named HS, IS, and OS. These 
work spaces are set to an initial size of six frames each (3000 bytes) at logon 
time. Some users require additional work space to run DATA/BASIC programs and 
manipulate larger items; this requirement may be specified in Attribute 8 of 
the user identification item, immediately following the system privilege code. 


The format of the “additional work space" parameter is: 
(n) 


where "n" is the work space requirement (in number of frames) for each of the 
three linked work spaces (HS, IS, and OS). The "n" parameter must be a decimal 
number greater than six (because six frames are initially made available by the 
system) and no more than 133. For example, if the requirement for line 8 is 40 
frames, (40-6)*3=102 frames must be available as a contiguous block. 


Additional work space is obtained from the pool of contiguous overflow space. 
The first priority is to obtain this work space from low disc space (see topic 
LOW DISC SPACE AND FILE AREA). If no space is available, the following message 
is displayed immediately after the "WELCOME TO SEQUEL" message: 


334 REQUESTED NUMBER OF ADDITIONAL WORK-SPACE FRAMES: xxxx IS NOT 
AVAILABLE. ADDITIONAL WORK-SPACE HAS NOT BEEN ASSIGNED. 


where "xxx is the amount of work space entered in Attribute 8 of the user 
identification item. 

If the format of the work space parameter is illegal (e.g., “n" out of range, 
missing parenthesis, nonnumeric "n", etc.), then the after message is returned 
immediately following the "WELCOME TO SEQUEL" message: 


333 THE FORMAT OF THE ADDITIONAL WORK-SPACE PARAMETER: xxxx I5 
ILLEGAL FOR THIS ACCOUNT NAME. 
ADDITIONAL WORK~SPACE HAS NOT BEEN ASSIGNED. 


where "xxxx" is the amount of work space entered in Attribute 8 of the user 
-identification item. 


Consider the sample situation where the entry in the eighth attribute of a user 
identification item is SY$1(10). This gives the user level one system 
privileges and 10 frames of work space per linked set. Thus, 12 additional 
frames have to be obtained from contiguous overflow space. This situation is 
illustrated in Figure A. It is assumed that the user logs in on process one 
which corresponds to a PCB FID of X7220° (544). The arrows in the figure 
represent frame linkages set up after logon. 
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WORK SPACE NAME FID(s) WORK SPACE 


PCB 544 ee ee ee 
SCB 545 ae oe 
TCB 546 fees h onesies enue 
he 547 Rene ee oe 
BMS, ete. 548 ae 
ts 349 RES pte eee ee) 
PROC work area 550-553 rod 


HS 554-559 


Original HS 
Original IS 
Original 0S 


Eee 


Is 560~=565 


os 566-571 


HS extension 9024-9027 


Additional HS 


Additional IS 
Additional 0S 


Figure A. Sample Additional Work Space Assignment 


IS extension 9028-9031 


OS extension 9032-9035 
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6.8 Allocating Permanent Blocks of Additional Work Space 


‘You may allocate a permanent block of additional work space via the WORKSPACE” 
verb. The Logon Work Space Table (LWST) keeps track of each "block" of space 

by listing the starting and ending frame id, the size of the block, its status, 

whether the block is linked, and the port currently using the block (if any). 


The WORKSPACE Verb 


This verb allocates and deallocates permanent blocks of additional work space. 
Its general format is: 


WORKSPACE size {(D) or (quantity) or (D,quantity) } 


where: 
size allocates one block of space three times “size” from low disc 
Space. This number corresponds to the number of additional 
frames (less six) requested on Line 8 of the account 
definition item in the System Dictionary. 
(D) deallocates one block of space and returns it to overflow. 


(quantity) specifies the number of porte that will be allocated (or 
deallocated) the specified block of space. 


Figure B shows several examples of how the WORKSPACE verb is used. 
The LOGON Work Space Table (LWST) 


This table defines the permanently allocated blocks of work space. Logged in 
this table are the starting and ending frame ids of each block and the status 
of that block. The integrity of the block links is uaranteed because this 
table is written back to disc every time the table is updated (i.e., this space 
is not lost following a coldstart). 


The LWST pee the added benefit of fast logon. Blocks of space are taken 
from available space and linked the first time they are used, rather than every 
time a terminal is louged on. Therefore, when a terminal is logged on, the 
additional work space frames do not have to be read and linked. 


Permanent Blocks 


When you. log on, the system first attempts to use a block of space permanentl 

allocated with the WORKSPACE verb. The LWST is searched for the smallest bloc 

of space not “IN USE" by another terminal that satisfies the size requested by 
Line Eight of the account definition item in the System Dictionary. If one is 
found, it is marked "IN USE" and linked to the terminal”s primary work space. 


Permanent blocks of space are not linked until the first time they are used. 
Therefore, the first time you log on after a coldstart or file restore, there 
is some delay while these frames are contiguously linked. Subsequently, they 
will already be linked and you will be immediately logged on. Permanent blocks 
of space may also be marked "“RELINK" when you log off from the assembly of 
DATA/ BASIC debugger or when the “L” option is used with the OFF command. If 
you are concerned about work space links, press the <BREAK> key, enter "OFF 
(L)", and then logon to relink your work space. 


Temporary Biocks 


When a suitable block of permanently allocated space is not available, a 
temporary block of overflow space is used. Note that you. will encounter a 
delay during logon while the temporary space is contiguously linked. When you 
log off, the temporary block is returned to overflow. Coldstarting the system 
while assigned to a temporary block causes the system to lose that block of 
space. 


96 83-1109 


6 LOGON/LOGOFF 


To view the current LWST table, execute the WORKSPACE verb without any 
parameters or options (see Figure C). 


The SYSTEM-SETUP PROC has been modified to reserve a maximum size block (133) 
for each terminal on the system. You should modify this PROC to accommodate 
your system needs. 


WORKSPACE size {(D) or (quantity) or (D,quantity)} 


Figure A. General Format of the WORKSPACE Verb 


Permanently allocates one block of 192 frames (66 x 
3 - 6) from Low Dise Space. The number 66 
corresponds to the number found in Line Right of the 
account definition item in the SYSTEM Diettonary. 
If a temporary bloek of 192 frames is found before a 
null LWST entry ts encountered, it ts converted to a 
permanent block. 


WORKSPACE 66 


WORKSPACE 33 (10) Allocates 10 blocks, each of which ts 93 frames. 


WORKSPACE (D) Leallocates one block of space and returns it to 
overflow. If the first permament block found is "IN 
USE", tt will be converted to temporary space and 
pe to overflow when the line using it loge 
Offs 


WORKSPACE (D,5) Dealloeatee & blocks of space. 


WORKSPACE 66 (D) Deallocates a block of space that econtaine 192 
frames. Thie eommand has no effeet tf a block of 
192 frames cannot be found. 


WORKSPACE 33 (D,5) Deallocates 5 blocks of space that each contain 93 
frames. 


Figure Bb. Sample Usage of the WORKSPACE Verb 


FROM SIZE/3 STATUS LINKED PORT 


7307 - 7396 30 T 4 63 IN USE 
8409 - 8468 20 Y 

9176 - ~ 9220 15 Y 

9300 - 9680 127 Y 12 IN USE 
9681 - 10061 


Note: The "“T" listed under STATUS means that block of space is temporary 
and will be returned to overflow when the user logs off. 


Figure C. Sample LOGON Work Space Table (LWST) 
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6.9 Security 


Security codes may optionally be placed in the L/RET and L/UPD attributes of a 
dictionary item to restrict access and update. At logon time, you are assigned 
the set of security codes which are in your user identification item. During 
the session, whenever an L/RET or L/UPD code is encountered, a search is made 
of the assigned codes for a match. If no match is found, you are denied 
accesses A code may consist of any combination of ASCII characters. 


L/RET and L/UPD 


Both file definition ("D" code) and synonym file definition ("Q" code) items 
have L/RET (retrieval locks) and L/UPD (update locks) attributes. When these 
attributes have stored values, they are known as security codes. Although 
there is no prohibition against multiple values for these attributes, only the 
first attribute value is matched against the user assigned codes. Since each 
file may be individually locked for both update and retrieval, your user 
identification item must contain the same security codes which protect the data 
you wish to access. Using this feature, a complex "mask" can be constructed 
for each user, giving you a different subset of files which you may access. 


Security at the file level is activated at the processor level. The following 
processors are assumed to be updating processors and, therefore, require a 
match on the L/UPD attribute in the file definition item: COPY, EDITOR, and 
the Assembler. Other processors, with the exception of DATA/BASIC, are assumed 
to be retrieval processors and require a match on the L/RET attribute in the 
file definition item. (See Microdata DATA/BASIC Programming Manual for an 
explanation of DATA/BASIC security features.) Failure to match one of the user 
security codes with either the L/RET or L/UPD attribute value generates the 
following message (and returns control to TCL): 


(210) FILE file-name IS ACCESS PROTECTED 


User Assigned Codes 


Each user identification item in the System Dictionary (see the topic USER 
IDENTIFICATION ITEMS in this chapter) contains the list of security codes 
assigned for that particular user. The lock code in the file being verified 
must match. 


Security codes may be assigned initially when an account is created via the 
CREATEACCOUNT PROC (refer to Chapter 11). Security codes may be added or 
deleted by updating the appropriate user identification item using the EDITOR 
(assuming one has the appropriate security codes); however, updates to the 
user identification item should only be performed when no one else is logged on 
to the system. 
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Care must be taken when securing the System dictionary and the SYSPROG account. 
SYSPROG (and any Synonyms, such as SP) should be protected first. Then SYSTEM 
may be secured, usually with the same codes as SYSPROG. Remember that there 
are two items in SYSTEM that should be secured with the same codes; their 
item-ids are SYSTEM and DL/Ib. If SYSTEM were to be secured before SYSPROG, 
then SYSPROG would not be able to access SYSTEM. 


Security Code Comparison 


Security codes are verified by comparing the value in the file dictionary 
against the corresponding string of values in the user identification item. 
Characters are compared from left to right. An equal (verified) compare occurs 
when the value in the file dictionary is exhausted and all characters match up 
to that point. This is illustrated in Figure A. 


When referenciny a file using a Q synonym (refer to Chapter 3), a security code 
match is made at all levels (i.e., SYSTEM, M/DICT, and file dictionary). 
Therefore, a correspondence must be maintained at all levels to process the Q 
synonym files. Because the user identification item for the account containing 
the primary file is verified for security codes, the user referencing the Q 
Synonym must have a code defined in this user identification item which will 
verify with the first code in the equated account’s user identification iten. 
Thus, in a user identification item, only the first code is used to protect the 
account from Q synonym accesses, while all the codes in the item are assigned 
to you when you log on. 


FILE DICTIONARY CODE USER IDENTIFICATION CODE RESULT 


123 123 MATCH 
MATCH 

NO MATCH 
Match 


No match 


Figure A. Sample Security Code Comparisons 
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6.10 Accounting History File: Introduction 


The Accounting History File is one of the mandatory files in the SEQUEL system. 
This file contains accounting history for the system, as well as entries that 
describe currently active (logged-on) users. 


The System Dictionary must contain the file definition item ACC and the file 
synonym definition item ACCOUNT for the Accounting History File, as illustrated 
in Figure A. (The System Dictionary must also contain a duplicate D-pointer 
“CHANNEL’ to ACC.) The ACC dictionary is set up for examining and listing the 
data in Accounting History File via ENGLISH (see the topic titled ACCOUNTING 
HISTORY FILE: SUMMARY AND EXAMPLES in this chapter). There are two types of 
entries (items) in the Accounting History File: those that represent active 
(logged-on) users, and those that keep track of accounting history. 


Active Users Items 


The item-id of an active user item in the Accounting History File is the 
four-character hexadecimal FID of the PCB of the user’s process. If the PCBs 
start at FID 512, (they proceed in steps of 32 frames from there on), a user 
logged on to process zero will have an entry with an item-id "0200" (512), 
while a user logged on to process one will have an entry with an item-id "0220" 
(544), and so on. Attribute 1 of an active user item contains the name of the 
user (i-e., the item~id of the user identification item), Attribute 2 the date 
logged on, and Attribute 3 the time logged one Active user items are created 
when a user logs on, and deleted when he logs off. (Attributes of an active 
user item are summarized in the topic titled ACCOUNTING HISTORY FILE: SUMMARY 
AND EXAMPLES in this chapter.) 


Accounting History Items 


The item-id of an accounting history item is the name of the user (iee., the 
item-id of the user identification item). Attributes 1, 2, and 3 are not used. 
The remainder of the attributes are described below: 


Attribute 4: Date(s) logged one Each unique date is stored. Value marks 
are tagged on to the value in this attribute if multiple 
logoffs occur on the same date (for LIST alignment 
purposes)» Date is stored in SEQUEL date format. 

Attribute 5: Time(s) logged on. An entry is made for each logoff, 
representing the time at which you logged on. Time is 
represented in seconds past midnight (24-hour clock). 

Attribute 6: Connect time(s). This entry represents the time in seconds 
between the logon and logoff. 

Attribute 7: Charge-units. A number representing the CPU usage (CPU 
milliseconds) is added for each logoff. 

Attribute 8: Disc-reads. This entry reflects the number of frame faults 
encountered between logon and logoff. 
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Your System dictionary item must have a ’U’ in Attribute Nine if you are to 
have your account file history items updated. The entries in the account file 
contain the history of each session (logon to logoff). If the System 
dictionary data has been changed since logon or the history item to be updated 
is too large for your work space, the following message is printed: 


ACCOUNT FILE STATISTICS WERE NOT UPDATED DUE TO EITHER: 


1. INSUFFICIENT WORKSPACE TO CONTAIN THE ACCOUNT FILE ITEM, OR 
2. SYSTEM DICTIONARY CHANGED WHILE YOU WERE LOGGED ON 


SYSPROG M/DICT 


Item “ACC’ - Item “ACCOUNT’ Item *CHANNEL’ 


001 D 001 Q 001 Q 
002 base - 002 ACC 002 ACC 
003 modulo 003 DL/ID 

004 separation 


ACC Dictionary 


Item ’DL/ID’ 


ACCOUNT File 


Active user items 
Accounting history items 


Figure A. Accounting History File Hierarchy 
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6.11 Accounting History File: 


This topic summarizes formats of 


items 


the Accounting History File. 


the active 
in the Accounting History File. 


Summary and Examples 


user items and accounting history 
Also presented are 


sample entries for 


Figure A summarizes attributes for the active user items and accounting history 


items. 
a value 
sample 
LIST statement. 
storage format. 


ATTRIBUTE 


NUMBER 


0 


This same item is 


“ACC’ DICTIONARY 
NAME 


(Item-id) 


Al 
A2 


A3 


DISC-READS 


TOT-CONN 


TOT-UNITS 


TOT-DISC-READS 


ACTIVE USER ITEM 


Four-character 
hexadecimal PCB-FID 


User name 
Date logged on 


Time logged on 


statement. 
the accounting history item for user FRANK via an ENGLISH 
"dumped" in Figure D to show its 


Figure B shows a sample sorted listing of the active users (users with 
for Attribute Al) via an ENGLISH SORT 
listing of 


Figure C shows a 


internal 


ACCOUNTING 
HISTORY ITEM 


User name 


Not used 
Not used 
Not used 
Dates logged on 
Times logged on 


Connect times 
(seconds) 


Charge units 
(CPU milliseconds) 


Disc reads 


Total connect 
times 


Total of CPU 
milliseconds 


Total of 
disc~reads 


*Multivalued attribute; one value for each LOGON/LOGOFF sequence 


Figure A. 


Summary of Active User Items and Accounting History Items 
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user name 


ACC ccecceeehAMBeececccsccessees ATE LOGGED ONe ceceeese TIME LOGGED ON 


0240 SYS PROG 12 APR 83 09; 15:16 
0280 12 APR 83 09: 53:16 
02C0 12 APR 83 09: 333 36 
0480 12 APR 83 08; 21:04 


4 ITEMS LISTED. eee: date logged on 


PCB=-FID=0240 
(channel two) 


Figure Be Sorted Listing of Active Users 


ACCseceveelA THe ose v et lMEe eee eCONNECT, « CHRGE DISC. ee eTOTA Le oe ese se TOTALe TOTAL 
LOGGED ON LOGGED ON TIME UNITS READS CONNECT UNITS DISC 
TIME RFADS 


FRANK 10 APR 83 08:38:43 00:32:12 302 2107 02:01:57 1217 7189 
09:11:51 00:05:00 58 307 
09:17:03 00:32:33 321 2009 
11 APR 83 10:50:00 00:03: 20 30 121 
11:06:40 00:08: 20 83 413 
08 JUN 83 11:08:31 00:40:32 423 2232 


Figure C. Listing of Accounting History Item for User FRANK 


dates logged on times Logged on connect times 


f 
FRANK~~~"4059] ] ] 4060] ] 4061731123) 33111]33423] 39000] 40000] 4011171932] 300] 1953]200 


© 1500) 24327302] 48] 321] 30]83] 42372107] 307]2009]121]413]2232 


1 ITEMS me / 


charge untts dtec-reads value mark attrtbute mark 


Figure D.- Dump of Accounting History Item for User FRANK 
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6.12 Accounting History File: Periodic Clearing 


To avoid overflowing the accounting history item in the Accounting History File 


for a specific user, the item should be periodically cleared. 


The point of overflow is determined by the activity of your account together 
with the amount of work space assigned to youe This point can be calculated by 
following the procedure detailed in Figure A. 


To clear your accounting history item, follow the steps detailed in Figure B. 
If the accounting history item for your account exceeds the available 
workspace, you can log off, but the Accounting History File will not be 


updated. To recover from this situation, follow the procedure detailed in 
Figure B. 
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1. Type the following: 


This lists the user identification item for the specified user. 
Attribute 8 shows the system level privilege followed by (in 
parentheses) the amount of work space. If a value is not shown for the 


work space, 6 is assumed. Multiply this value py 100 to compute an 
approximate maximum size. 


To determine the current size, type: 


This produces the following output: 


STATISTICS OF ACC: 
TOTAL = xxx AVERAGE = yyy COUNT=1 


If the value displayed for TOTAL in Step 2 (i.e., “xxx") approaches the 
value calculated in Step 1, then the user-account is approaching the 
overflow point. 


Figure A. Procedure to Determine Overflow Point 


Logon to the SYSPROG account 


Type the following: 


Type the following: 


Figure B. Procedure to Clear Specific Accounting History Item 
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7.1 Overview 


This chapter describes the data base management processors for the SEQUEL 


system. 


The file management processors provide capabilities for creating, managing, and 
manipulating files and items within the SEQUEL system. File management 
processors include the CREATE-FILE processor, CLEAR-FILE processor, DELETE-FILE 
processor, and COPY processor. 


CREATE-FILE Processor 


The CREATE-FILE processor generates new dictionaries and/or data files. The 
processor establishes file dictionaries by creating "D" entries in your Master 
Dictionary (M/DICT) and reserving and linking primary file space. You need 
only specify values for the desired modulo(s) and separation(s). 


CLEAR-FILE Processor 


The CLEAR-FILE processor eliminates the data from a file (i.e., it sets the 
file to the "empty" state by placing an attribute mark in the first data 
position of each group of the file). "Overflow" frames that may be linked to 
the primary file space will be released to the system’s overflow space pool. 
Either the data section or the dictionary section of a file may be cleared. 


DELETE-FILE Processor 

The DELETE-FILE processor deletes a file. Either the data section or both the 
dictionary and data sections (if present) of the file may be deleted. Frames 
are returned to available space. 

COPY Processor 

The COPY processor copies an entire file or selected items from the file to the 


terminal, to the printer, to another file or to items with different item-ids 
within the same file. 


Examples 


As a general introduction to this chapter, Figure A presents a number of 
examples illustrating the use of file management processors. 


Additional File Management Procedures 


Additional file management procedures (such as the creation of new 
user-accounts, saving and restoring of files, etc.) are detailed in Chapter 11, 
SYSTEM MAINTENANCE PROCEDURES. 
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EXPLANATION 


Creates a file dictionary for the TEST 
file, with a modulo of 1 and a 
separatton of 1. 


Heserves dise espace for the data area 
of the TEST file, with a modulo of 7 
and a separation of 2. 


Creates a file dictionary for the FNA 
file, with a modulo of 1 and a 
separation of 1. Also creates the 
data area of the FNA ftle, with a 
modulo of 8 and a separation of 1. 


Clears data section of XYZ files. 


Deletes dicttonary sectton of INV ftle 
(assuming NO DATA SECTION). 


Deletes data and dicttonary sectton of 
FAE file. 


Copies data item I1, I2, and I3 back 
tnto the same file (TEST) giving 
dupltcate items with item-tds of XI, 
X2 and X38. 


Coptes all dicttonary items from file 
SAMPLE to dtettonary of file FLAVORS. 


Coptes all tteme in the TEST file to 
your terminal. 


Figure A. Sample Usage of File Management Processors 
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7.2 Creating New Files: CREATE-FILE Processor 


The CREATE-FILE processor generates new files and dictionaries in the SEQUEL 


system. 


The CREATE-FILE processor establishes file dictionaries by creating "D" entries 
in your Master Dictionary (M/DICT). The CREATE-FILE processor is also used to 
reserve disc space for the data portion of the new file by automatically 
placing the DL/ID (Data-Level Identifier) entry in the file dictionary, which 
then points to the data area. CREATE-FILE will automatically locate and 
reserve a contiguous block of disc frames from the available space pool. You 
need only specify values for the modulo and the separation of both the file 
dictionary and data area (Figure A). (For a discussion of the values to use 
for modulo and separation, refer to the topic SELECTING MODULO AND SEPARATION 
in this chapter.) 


The dictionary portion (DICT) of the file must always be created first. The 
name given to the new file must not exist in the user M/DICT. The general form 
for creating a file dictionary is: 


CREATE=FILE (DICT file-name m,s) 


where “file-name" is the name given to the file, "m" is the desired modulo, and 
"s" is the desired separations An example is shown in Figure B, where the DICT 
for a file named SAMPLE is being created. 


Once the DICT has been created, the primary file space for the data area of the 
file can be reserved. The general form is: 


CREATE-FILE (DATA file-name m,s) 


where "file-name" is the name given to the file, "m" is the desired modulo, and 
"s" is the desired separations An example its shown in Figure C. (Note that a 
data area need not be reserved for a single-level file where data is to be 
stored in the DICT.) 


The most common form of the CREATE-FILE command is shown below. This enables 
the creation of both the dictionary and data areas with one command. The 
general form is: 

CREATE-FILE (file-name ml,sl m2,s2) 
where "file-name" is the name of the file, "mi" and "sl" are the modulo and 
separation of the DICT (respectively), and "m2" and "s2" are the modulo and 


separation of the data area. This usage is shown in Figure D. 


The BREAK key is inhibited during a CREATE-FILE. 
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CREATE-FILE (DICT file-name m,s) 
separation | 


dtetionary 
separation 


mete 


CREATE-FILE (DATA file-name m,s) 


dtettionary 
modulo 


CREATE<FILE (file-name ml,sl m2,s2) 


data 
modulo 


Figure A. General Forms of CREATE-FILE Command 


data 


separatton 


FILE “SAMPLE’ CREATED; BASE = 14946, MODULO = 1,SEPAR = l. 


Figure Be. Sample Creation of Dictionary Portion 


FILE “DL/ID’ CREATED; BASE = 14947, MODULO = 11, SEPAR = l. 


Figure C. Sample Creation of Data Portion 


FILE “SAMPLE2” CREATED; BASE = 14980, MODULO = 1, SEPAR = l. 
FILE “DL/ID’ CREATED; BASE 15132, MODULO = 11, SEPAR = l. 


Figure D. Sample Creation of Both Dictionary and Data Portions 
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7.3 Selecting Modulo and Separation 


Efficient file accessing and disc use depends on proper selection of modulo and 


separation. 


'Modulo'' is the number of groups in a file; "separation" is the number of 
contiguous frames per groupe A file is created by specifying its modulo and 
separation parameters; the frames allocated by the system (modulo*separation) 
are referred to as the "primary" file-space. As data is placed into the file, 
any group may overflow by attaching frames from the available system space 
pool; this space is referred to as the "overflow" file-space. To locate an 
item, given its item-id, the item-id is "hashed" using the modulo of the file, 
which results in a unique group number in which it may exist. The item-ids in 
that group are then linearly searched for the required item. A proper 
selection of the "modulo" parameter is essential to minimize this search time. 
The current maximum modulo and separation are 8,388,607 and 127 respectively. 


In the current file structure, the SEPARATION parameter is of practically no 
value. The disc-head will almost definitely have moved between the moment that 
a process requests one frame of the group and the next; therefore, whether the 
next linked frame of the group is contiguous (that is, if the separation is 
one) or not makes a marginal difference. What this amounts to is that there is 
little difference in accessing a frame in "prime" file-space and in "overflow" 
space, particularly since the file-restore process "compacts" all files and 
leaves the "prime" and "overflow" frames close to each other. 


Selecting a proper MODULO is extremely important, since the number of groups 
directly affects the search and update time for an item in the group. What is 
proposed here is a modulo selection process that would make the average GROUP 
length between one and two frames (iee., at most two frame faults to find a 
particular item). Obviously, if the item-size is of the order of 250 bytes or 
greater, this rule of thumb must be modified. 


The number of frame faults -- the factor that causes the most degradation of 
overall system response -- increases dramatically as the number of frames per 
group increases. This is because, on the average, half of the frames in a 
group have to be written back to the disc after an item update. Thus, to 
update an item in a group, we have to read every frame in the group and write 
half of them (see Figure A). 


A good rule of thumb is to select the MODULO to be the smaller of: 


(1) ‘The number of bytes of data or (2) The number of items 
500 


and use a separation of one. 
The DATA/BASIC program “SET-ALLOCATION’ in SYSPROG-PL uses these formulas to 


set the reallocation parameters (contained in attribute 13 of the file 
definition item) for existing files. 
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Using the table, one can select an appropriate ITEMS/GROUP value; knowing the 
expected number of items in the file then gives the approximate modulo. Modulo 
must not be a multiple of 2 or 5. 


Type Frames per Group 
of 


Activity 


READ 
UPDATE 


Figure As Disc Operations Versus Frames/Groups 


If Then And 
Avg Item-Size Item/Group Bytes/Group 
‘ Should Be Will Be 


440 
455 
450 
900 
900 
937 
900 
1400 
1400 
1450 
1920 
1925 
1920 
1900 
3000 
4000 


es @e 6 e 
DOwmWOAUNFWODVOMWMOADAVDAOS 


OWW UD Uns © AW~I WO HO WH DS 


Figure B. Selecting Items/Group 


Avg Item Approximate Items/Group Approximate 


No. of Items (From Figure B) Modulo 


800 
5000 
1800 

230 


36 
383 
257 
287 


Figure C. Examples of Computing Modulo 
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7-4 Clearing & Deleting Files: CLEAR-FILE & DELETE-FILE Processors 


The CLEAR-FILE processor clears (i-e., empties) files. The DELETE-FILE 


processor deletes files. 


The CLEAR=FILE processor clears the data from a file (i.e., it sets the file to 
the "empty" state by placing an attribute mark in the first data position of 
each group of the file). "Overflow" frames that may be linked to the primary 
file space will be released to the system’s additional space pool. Either the 
data section or dictionary (DICT) section of a file may be cleared using the 
CLEAR-FILE verb. If the dictionary section is cleared, and a corresponding 
data section exists (as implied by the presence of the DL/ID item in the 
dictionary), then the DL/ID will be maintained in the dictionary. The <BREAK> 
key is inhibited during the DELETE process, but not the CLEAR process. 


To clear the data section of a file, the following verb is used: 
CLEAR-FILE (DATA file-name) 
To clear the dictionary section of a file, the following verb is used: 
CLEAR=FILE (DICT file-name) 
The DELETE-FILE processor erases a file. Either the data section, dictionary 
section, or both of these file sections may be deleted. The dictionary section 
of a file which has a data section cannot be deleted until the data section is 
deleted. All frames no longer required are returned to the available space 
pool. 
To delete the data section of a file, the following verb is used: 


DELETE-FILE (DATA file=name) 


which will delete the data section pointed to by the DL/ID and will also delete 
the DL/ID from the dictionary section. 


To delete the dictionary section of a file, the following verb is used: 
DELETE-FILE (DICT file-name) 

To delete both the data and dictionary sections, the following verb is used: 
DELETE-FILE (file~name) 

In the latter two cases, the file-definition item in the M/DICT (the file-name) 

is also deleted. Files defined by file-synonym in the user’s M/DICT cannot be 


specified in a DELETE-FILE verb. These definitions should be deleted with the 
DELETE PROG or the EDITOR. 
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CLEAR-FILE and DELETE-FILE should not be used on files containing group format 
errors. If the cause of the group format errors is due to incorrect frame 
linkages, use of these verbs could destroy data in other files. Either repair 
the error (refer to the topic GFE’S: FIX-FILE-ERRORS VERB) or delete the file 
definition item in the M/DICT (all associated space will be lost until a 
restore is performed). 


The CLEAR-FILE and DELETE-FILE verbs are summarized in Figures A and 8B, 
respectively. Figure C presents examples. 


CLEAR-FILE (DATA file-name) ~«—-~—--——- Cleare data sections. 


CLEAR-FILE (DICT file-name) +————_—_—— -leare dicttonary sectton. 


Figure A. General Forms of CLEAR-FILE Verb 


DELETE-FILE (DATA file-name) +-————— Deletes data sectton. 

DELETE-FILE (DICT file~name) «a——————~- Deletes dicttonary section. 

DELETE-FILE (file-name) «——_—_——__—_—_—__— Deletes data and dtettonary 
section. 


Figure B. General Forms of DELETE-FILE Verb 


EXPLA NATION 


~——————— Cleare data section of ftle 
. TESTFILE. 
+————_———— Clears dictionary seetton of 
ftle EMPL. 


<-—______—_—-- Deletes data section of file 
A/P. 

i—____—-— Deletes dictionary section of 
file INV. 

+ Deletes data and dtettonary 
section of file PAYROLL. 


Figure Ce Sample Usage of CLEAR-FILE and DELETE-FILE Verbs 
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7.5 Copying Items: Copy Processor 


The COPY processor copies items from a file to the terminal, printer, to 


another file (either in your account or in some other user-account), or to 
items with different item-ids within the same file. 


The COPY processor is evoked via the COPY verb. The general form is: 
COPY {DICT} file-name item-list* or * {(options)} 


The "“file-name" parameter specifies the source file. The “item-list" consists 
of one or more item-ids separated by blanks, or an asterisk (*) specifying all 
items. The item-list specifies items to be copied. The “item-list*" need not 
be included if processing a selected or saved item-list (refer to the ENGLISH 
Programming Manual). The “options” parameter, if used, must be enclosed in 
parentheses (see the topic titled ADDITIONAL COPY PROCESSOR FEATURES in this 
chapter). tiultiple options are separated by commas. Once a COPY command has 
been issued, the COPY processor responds with: 


TO: 


You must then enter the item-id(s) for the destination of the COPY operation 
(if the COPY is to the same tile), or you must enter the destination file-name 
(enclosed in parentheses) optionally followed by the destination item-ids (if 
the copy is to another file). The first COPY operation in Figure B illustrates 
the creation of a new item WORTH in DICT SAMPLE by copying the existing item 
COST from DICT SAMPLE. The second operation illustrates the creation of one 
data item (1242-99) from another (1242-01) in the same file. 


When using the COPY operation, multiple items may be specified as source and 
destination. Each item-id must be separated by a space and may be repeated 
within the item list. There may be different numbers of items within the 
source and destination lists. If the source file list is exhausted first, the 
COPY terminates. If the destination file list is exhausted first, the 
remainder of the items are copied with no change in item-id. The third example 
in Figure B copies data items RED, WHITE, and BLUE back into the same file 
(called FLAVORS) but gives them item-ids of ALPHA, BETA, and GAMMA. 


When copying items with explicit source and destination item-lists, care should 
be taken to ensure that all of the source items exist. If an item being copied 
is “NOT ON FILE’, it causes the source-destination correspondence to be out of 
sequence. 


If copying all existing items is desired, an asterisk (*) may be used as the 
item-list or the list may be supplied by a previous SELECT, SSELECT, GET-LIST, 
or FORM-LIST. Figure C illustrates a COPY of all dictionary items from file 
SAMPLE to the dictionary of file FLAVORS. Note that when a destination of 
other than the source file is desired, the destination file must be enclosed in 
parentheses. (If a destination file is not specified, the items will be copied 
into the original file). Note also that if the dictionary is the destination, 
the word DICT must be included within the parentheses (see Figure C). 


When copying from one dictionary to another, the COPY processor does not copy 
dictionary items which have D/CODE=D (such as the DL/ID entry). DL/ID entries 
must only be created by the CKEATE-FILE processor. To recreate both dictionary 
an ata sections of one file in a new file, a command sequence such as_ the 
example shown in Figure D must be used. Great care should be taken when 
copying to dictionaries to avoid overlaying D-pointers when using the “07 
option. 
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Note that to COPY to another users account, a file synonym definition 
(D/CODE=Q) which points to that specific account and file must already exist. 


COPY {DICT} file~name item-list* or * {(options)} 


1 see topte titled ADDITIONAL 
COPY PROCESSOR FEATURES 


—— Single dtetionary ttem copted. 


1 ITEMS COPIED 


—_————_ Single data item copied. 


ra———— Multiple data items copted. 


Figure B. Copying Items to Same File 


<——_—___———- All dicttonary tteme copied. 


DL/ID NOT COPIED 
2 ITEMS COPIED 


<~—_$______________ Copy one ttem to a different file 
with a new ttem-id. 


Figure C. Copying Items to Different File 


«—— New file created. 
[ : 15417, MODULO = 1, SEPAR = 1. 
[417] FILE “DL/IbD” CREATED: BASE = 15418, MODULO = 3, SEPAR = l. 


All dicttonary items (except 
DL/ID) eopted. 


—— OAL ata: tteme copred. 


Figure D. Creation of Entire Dictionary and Data Sections 
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7.6 Additional Copy Processor Features 


The COPY processor may be used to copy items to the printer or to the terminal. 


Several options are additionally available for use with the COPY processor. 


Items may be copied to the terminal by entering a null line (carriage return 
only) in response to the "TO:" message or by using the “I~ option (Figure B). 


Several options are available for use with the COPY processor. Desired options 
are specified by one or more single characters separated by commas. The entire 
options list must be enclosed in parentheses and must follow the item-list in 
the COPY command (see the topic COPYING ITEMS: COPY PROCESSOR). Valid options 
are listed in Figure A. 


Note that not all combinations of option characters are meaningful. “D” and 
“0° options only apply on a file-to-file copy. “X° and “L” options apply only 
on a copy to the terminal or printer. 


The sample in Figure C copies two items from the FLAVORS file back into the 
FLAVORS file, changing the item-ids from ALPHA to BLUE and from BETA to YELLOW. 
Items ALPHA and BETA are deleted. If either item previously existed (BLUE or 
YELLOW), it is overwritten. 


The example in Figure D shows the creation of a new file and copying the entire 
-xyZ" file to “ZZZ°. The modulo and separation are specified the same as in 
the CREATE-FILE. 


OPTION DESCRIPTION 


Deletes items from source file after they are copied to the 
destination file. (Thies option may not be used with the 'P' or 'T' 
optton.) 

Liste destination ttem-ids as they are copted. 

Suppresses Line-numbere on a copy to the terminal or printer, when 
used with the 'T' or 'P' option (respectively). 

Suppress automatie paging of output when used with the 'T' option. 
Overwrites destination file items with source file items if ttem-ide 
are the same. (This option may not be used with 'P' or 'T' option.) 
Copies items to the printer (spooler). 

Suppresses printing of "'ttem-id' NOT COPIED" messages. 

Coptes iteme to your terminal. 

Specifies a hexadecimal dump to the terminal or printer, when used 
with the 'T' or 'P' option (respectively). , 


Figure A. COPY Processor Options 
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(Item LISTACC will be displayed at the terminal.) 


Figure B. Copying Items to Terminal 


2 ITEMS COPIED 


Figure C. Sample Usage of COPY Options 


[417] FILE °Z2Z2° CREATED, BASE=3633, MODULO=1, SEPAR=1 
(417) FILE “DL/ID’ CREATED, BASE=22391, MODULO=1, SEPAR=1 


6 ITEMS COPIED 


(NOTE: Data tteme are copied, not dtcttonary ttems) 


Figure D. Creating New File During Copy Process 


8 SPOOLER 


8.1 OVERVIEW 


The SEQUEL computer system is a multiuser system which permits each user to 
perform processing operations with complete independence from other users. 
However, each system printer and magnetic tape unit can only support one user 
at a time. The SEQUEL spooler resolves such conflicts by providing 


simultaneous output to a maximum of four system printers, one tape drive, and 
as many ports as each system configuration will allow. The spooler enables 
each terminal to continue processing even if the desired peripheral is 
temporarily unavailable. 


The spooler allows multiple users to share SEQUEL’s system peripherals. Output 
reports are "spooled", which frees the terminal to initiate some other 
processing task. When the designated peripheral device and the "despooling" 
processor become available, the report is automatically "despooled" from the 
disc unit to either a magnetic tape, a system printer, or a terminal port. 


Print Jobs 


Individual reports to be spooled to an output device are called "print jobs". 
A print job may be created by a PROC, an ENGLISH statement, a TA TA /BASIC 
program or other processor. Before a print job can be output, it must be 
assigned to a form queue. The spooler will accommodate up to 300 print jobs. 


Form Queue 


A form queue is a “list" of print jobs waiting to be despooled. Print jobs are 
assigned to a form queue via the SP-ASSIGN verb. Once created, the form queue 
may be assigned to an output device (a system printer, a tape unit, or a 
terminal port). If the device assignment is successful (i-e-, no other form 
queue is assigned to that device), output may then begin. 


Line-At-A-Time Mode 
Using the SP-ASSIGN verb with an ‘N’ option, you may bypass the spooler. In 
this case, the process outputs text directly and immediately to the attached 


output device. This is called line-at-a-time output. 


Figure A shows a listing of the major spooler features. Figure B illustrates a 
procedure that may be used to spool a print job to an output device. 
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The SEQUEL spooler offers the following features: 


Simultaneous output to a maximum of four line printers, one magnetic 
tape unit, and as many ports as the system configuration will allow. 


Ability to restart a print job when the printer malfunctions. 
Creation of as many form queues as necessary. 

Movement of one or more print jobs from one form queue to another. 
Ability to change order of print jobs in queue. 

Reassignment of devices to form queues by device type and number. 
Specification of up to’ 100 print job copies. 

Examination of closed jobs. 


SP-STATUS display to show the current status devices 
spooled reports, open and closed. 


Reports when spooler has aborted via SP-STATUS. 


System restart without loss of closed hold files. 


Figure Aw Major Features of SEQUEL Spooler 


A procedure that may be used to spool a print job to an output device: 


l. Create a form queue. 


2. Assign the print job to a form queue. 


3. Assign form queue to an output device. 


Figure B. Sample Procedure for Spooling a Print Job 
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8.2 Overview (Continued) 


Spooler Verbs 


Figure A summarizes those verbs capable of communicating with the spooler. The 
"Screen-Oriented Verbs" (SP-STATUS and SP-JOBS) produce a screen display 
showing current spooler status. Immediately following each display is a “menu” 
of action codes you may enter to perform the desired spooling function. These 
action codes are listed below SP-STATUS and SP-JOBS in Figure A. 


Each verb listed under "ICL Verbs" (except SP-ASSIGN, SP-PORTON, SP-PORTOFF, 
and SP-KILL) performs the same function as the action code displayed on the 
same line. However, the "TCL Verbs" do not cause a status display to appear. 


If you do not remember the sequence of required parameters needed to execute a 
spooler verb, press the RETURN key immediately after entering the verb. The 
system will then display the required parameter(s) in the correct sequence. 


Device Attachment 


SEQUEL avoids conflicts by permitting only one process at a time to use each 
device. System software keeps track of device attachments. Spooler users need 
not be concerned with attachment/detachment since the spooler automatically 
attaches the appropriate unit before output begins, and automatically detaches 
the device when the queve is empty. 


Queue Assignment 


When the system is initialized, a form queue STANDARD is created and assigned 
to printer #1. Any print job created without an SP-ASSIGN statement will be 
put in the STANDARD form queue. You may modify this assignment at any time by 
executing the SP-ASSIGN verb. Several options are available (i.e., creation of 
hold files, instant output, nonspooling, and suppressed output). See the next 
topic, ASSIGNMENT OF PRINT JOBS AND OPTIONS: SP-ASSIGN VERB. 


NOTE: Although the SEQUEL computer system allows you to change the name of the 
STANDARD form queue, the default queue will be referred to as STANDARD 
throughout this manual, 


Hold Files 


‘The creation of hold files permits print jobs to be spooled to the disc and 
held for an indefinite length of time for subsequent output. The spooler may 
accommodate up to 300 jobs including hold files. The actual number of entries 
your spooler can handle is dependent on the amount of overflow space available. 
Hold files are normally created for jobs requiring special forms or very 
lengthy jobs. Hold files may now be recovered if an “X° or “A” system restore 
or :RESTART-SPOOLER is performed. 
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Screen-Oriented Verbs 


SP-STATUS 
Create Form Queue 


Change Form Queue 
Change Form Type 


Change Device Assignment 
Change Page Skip 


List Print Jobs 
Delete Form Queue 
Page Eject 
99 

SP-JOBS 
Move Form Queue 
Move Print Job 


Change Options 
Change #of Copies 


Delete Job 

Stop Printing 
Kesume Printing 
Edit Print Job 
Change Priority 
Suspend Printing 


SP-STATUS 
99 


Figure A. 
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TCL Verbs 


SP-CREATE 


SP-FORM 
SP-TYPE 


SP-DEVICE 
SP-SKIP 


SP-JOBS 
SP-FQDELETE 


SP-EJECT 


SP-MOVEQ 
SP-SWITCH 


SP-OPTS 
SP-COPIES 


SP-DELETE 
SP-STOP 
SP-KESUME 
SP-EDIT 
SP-PRIORITY 
SP~SUSPEND 


SP-STATUS 


SP-ASSIGN 


SP-LOOK 
SP-PORTON 


SP-PORTOFF 
SP-KILL 


Explanatton 


Displays status of spooler and 
all output devices. 


Creates a _ form 
optionally assigns 
device. 
Changes the 
queue. 
Changes type of form used. 
Assigns device to a form queue. 
Changes number of pages ejected 
from printer after exhausting 
the form queue. 

Displays SP-JOBS sereen. 

Causes form queue to be released 
from table. 

Causes attached printer to eject 
specified number of pages. 

Exits sereen display. 


queue and 
tt to a 


name of a form 


Displays status of print jobe. 


Moves all print jobs of form 
queue to another form queue. 
Moves a print job from current 
form queue to another. 

Changes options ona print job. 
Spectfies number of times a 
print job will be printed. 
Deletes one or more print jobs. 
Stopes printer. 
Reactivates spooler. 
Allows examination of 
Jobs. 

Changes print job 
within a form queue. 
Caneels printing but does not 
delete job. 

Displays SP-STATUS screen. 

kette sereen display. 


print 


priority 


Assigns option codes, 
job eode, and/or 
subsequent print 
queue. 

Displays parameters of current 
SP-ASSIGN statement. 

Starts terminal as a _ spooler 
port. 

Logs off an SP-PORTON ltne. 
Vaneels and deletes currently 
printing job. 


a print 
: assigns 
jobs to a 


Summary of Spooler Verbs 
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8.3 Assignment of Print Jobs and Options: SP-ASSIGN Verb 


The SP-ASSIGN verb delegates print jobs to a form queue and may assign options 


to subsequent print jobs; SP-ASSIGN may also assign a print report number to a 
queue and/or specify the number of job copies to be output. 


The general form of the SP-ASSIGN verb is: 
SP-ASSIGN {{n} =form-queue-name {copies}} {options} 
where: 


n specifies the print report number found in the PRINT 
ON statement of the corresponding DATA/BASIC program 
(refer to DATA/BASIC Programming Manual). If “n" is 
omitted, the assignment applies to all files except 
those with a specific SP-ASSIGN statement (i.e., this 
statement becomes’ the default and all previous 
assignments are cleared). Note: If “n” is entered, 
you must also include "=form-queue-name". 


=form—-queue-name specifies the name of the queue to receive print 
job(s). This name must be less than or equal to 20 
alphabetic, numeric or special characters (asterisks 
may not be used). 


options may be one or more of the following: creation of hold 
files, instant output, no spooling and suppress 
output. 


copies specifies a number from 1 to 100 which represents the 
number of copies to be printed. Should "copies" not 
be specified, the default value is "1". 


If no SP-ASSIGN statement is used, print jobs are put in the STANDARD form 
queue. Should an SP=ASSIGN verb be executed with no parameters or options, the 
job assignment is reset to the default queue STANDARD. This same result occurs 
when the operator logs off. If options and/or copies are specified in a 
SP-ASSIGN statement without using "“=form-queue-name", the STANDARD form queue 
is assumed. 


Options may be input in any sequence. The option(s) remain in effect until the 
next use of the SP-ASSIGN verb. There are four SP-ASSIGN options as shown in 
Figure A. Descriptions of these options follow. 


H -— Create Hold File on Disc 


The “H* option retains a print job on disc after printing is completed. Jobs 
which require special forms or special manipulations can be handled with this 
option. When a print job is assigned to a hold file, the message “ENTRY #n" 
appears on the screen. The “n° specifies the print job number of the hold 
tile. 


The “H* option cannot be used with the “N* option (which is explained on the 
following page). 
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I - Instant Output 


The spooler normally waits for an output report to be completed (closed) before 
it begins the output. By using the ‘1’ option, the spooler begins output as 
soon as the first frame of output is available. The frames of the job are then 
released back to the overflow table as soon as they are printed. Should a 
malfunction occur while outputting a print job with an ’I’ option, you may 
suspend printing; however, you cannot recover any data already printed. 
SP-RESUME causes output to begin where it left off. The ‘I’ option is 
incompatible with multiple copies and the ’N’ option. 


N = No Spoolin Output Directly to Device 


The “N’ option specifies no spooling. Data is output a line at a time to the 
assigned device. If the device is not available, you are notified and the ’N’ 
option is removed from the assignment. This option should be used only when 
the intent is to prohibit other users from accessing the output device. The 
device(s) will become attached to your line and will require you to detach the 
device(s) when complete so that others (including the spooler itself) may gain 
control. The ’N’ option is incompatible with the ‘I’ or ’H’ options, multiple 
copies and with output to a port. 


S_- Suppress Output 


The “S’ option suppresses spooler output. Normally, the ’S’ option is used 
with the °H” option. However, if the °S’ option appears alone, an output job 
is built but not printed because the job is not queued for output. 


Figure A displays a list of incompatible spooler option and device 
combinations. 


Spooler Incompatible Option 
Options and Device Combinations 


Copies 
H, Copies, PORT 
N 


N 


N 
I N, 
I 
Copies L 


, 
> 


NOTE: If any of the above combinations are used, the following error message 
appears: INCOMPATIBLE OPTIONS: NI, NH, N COPIES, I COPIES, OR N PORT. 


Figure A. Display of Incompatible Spooler Option and Device Combinations 
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8.4 General Format and Examples of SP-ASSIGN Verb 


The yeneral format of the SP-ASSIGN verb is shown in Figure A. Note that each 


parameter is separated by one space. Figure 8 illustrates the use of the 
SP-ASSIGN verb. 


Number 
Name of from 


Pomm-queuey |) 4-¢0°100 


SP-ASSIGN {{n} =form-queue-name {copies}} {options} 


Print report number assigned in Create hold file on 

PRINT ON statement of DATA/BASIC dise 

program creating the print job. Instant printing 
No spooling (output 
dtrectly to device) 
Suppress output 


Figure A. General Form of SP-ASSIGN Verb 
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EXAMPLE 


:SP-ASSIGN 


sSP-ASSIGN =INVOICE 


:LIST ENG *750L’ (P) 


:SP-ASSIGN 1 =CHECK IL 


*SP-ASSIGN =STANDARD HS 
:RUNOFF INV RECEIPTS (P) 


ENTRY #6 


:SP-ASSIGN =CHECK N 
:LIST PROD “PART#’ (P) 


:SP-ASSIGN H 


:SP-ASSIGN =INVOICE 
:SP-ASSIGN 1 =CHECK HS 


Figure C. 
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EXPLA NA TION 


Spooler device asstgnmente are cleared and all 
future print jobs are assigned to form queue 
STANDARD. 


A print job containing item "750L" ts assigned 
to the form queue INVOICE. 


All future print jobs with a print report 
number of "1" will be assigned to form queue 
CHECK with the optton of tnstant printing. 


All future print jobs will be assigned to the 
STANDARD form queue ae hold files wtth 
suppressed printing. Print job #6, which 
contains the ttem "RECEIPTS", te now a hold 
file. 


A print job containing the item "PART#H" te 
asstgned to form queue CHECK and is output a 
Line at a ttme to the assigned device. 


All future print jobs assigned to the default 
form queue will be hold files. 


All jobs except those with print report #1 
will be assigned to INVOICE. 


Sample Use of SP-ASSIGN Verb 
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8.5 Displaying SP-ASSIGN Parameters: SP-LOOK Verb 


The SP-LOOK verb displays the parameters used in your current SP-ASSIGN 


statement. 


The format of the SP=-LOOK verb is 
SP=LOOK {line #} 


To display the parameters of your current SP-ASSIGN statement, enter: 


If you wish to display the SP-ASSIGN parameters for another terminal, enter: 
:SP=-LOOK line# 


where ‘’line#’ represents the port number you wish to access. If the port 
number you enter is greater than or equal to the spooler’s line number, the 
message "LINE # TOO LARGE" is displayed and you are then returned to TCL. 


After executing the SP-LOOK verb, you may also see the following message: 
DEFAULT ASSIGNMENT IS TO QUEUE "STANDARD". 
This message appears: 


1. After you log on and before either an SP-ASSIGN statement is entered or 
before a print job is run. 

2. After you enter an SP-ASSIGN statement with no parameters and before a 
print job is run. 


The system maintains an assignment table that logs in your current SP-ASSIGN 
statement. The above message appears because you do not currently have an 
entry in the table. If you execute an SP-ASSIGN statement without parameters 
or options, any previous table entry assigned to your process is removed. 
Should you execute an output operation without an entry in the assignment 
table, one will be created and assigned to the STANDARD form queue. 


Figure A illustrates the use of SP=LOOK when viewing the SP-ASSIGN parameters 


for your own terminal. Figure B shows you how to display the SP-ASSIGN 
parameters for another port. 
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SP-LOOK {line#} 


Figure A. General Format of SP-LOOK Verb 


FURM QUEUE = STANDARD 
DEVICE TYPE LINE PRINTER 


DEVICE NUMBER 1 
SPOOLER OPTIONS HS 
CUPLES = 1 


Figure 8. Displaying SP-ASSIGN Parameters For Your Own Terminal 


FURM QUEUE = TAPEOUT 


DEVICE TYPE TAPE 
DEVICE NUMBER 


SPOOLER OPTIONS 
COPIES = 


Figure C. Displaying SP-ASSIGN Parameters for Port 18 
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8.6 Displaying Status of Spooler: 


SP-STATUS Verb 


The SP-STATUS verb displays current spooler status. 


The general form of the SP-STATUS verb is: 


The SP-STATUS verb displays: 
forms 
output device, 


SP-STATUS 


used, 


3) the device number assigned to each form queue, 4) the 
5) the status of 


1) the name of each form queue, 2) the types of 


type of 


each device, 6) the number of print jobs 


waiting to be printed, and 7) the number of page skips specified. 


The device status may be one of the following: 


At 


Status Explanation 

NEED DEV The desired device is attached to another line. 

CABLE OFF The cable to the line printer is not plugged in. 

NOT READY Device is off-line or, if device is a tape unit, the mounted 
tape has no write ring. 

NEXT REEL Tape drive needs a new reel. 

PARITY A parity error has occurred on tape. 

SUSPEND A suspend order has been issued. 

STUP A stop order has been issued. 

ACTIVE Device is outputting a job. 

ASSIGNED The queue is assigned to a device but there are no jobs ready 
for output. 

WALTING Queue is waiting for a device that is currently assigned to 
another queue. 

NO DEVICE Queue is not assigned to a device. 


any given 


time, more than one of the 
exist (e.g., ACTIVE and ASSIGNED or SUSPEND and NOT READY); 
Status condition is displayed. 


status conditions listed above may 
however, only one 


The display priority is: CABLE OFF, NEXT REEL, 


PARITY, SUSPEND, NEED DEV, NOT READY, STOP, ACTIVE, ASSIGNED, WAITING. 


Immediately following the 


status display is a list of action codes. You may 


enter the desired action code 
CODE:". 


number in response to the prompt "ENTER ACTION 


If the KETUKRN key is pressed in response to 
the SP-STATUS screen is displayed again. To 
enter Action Code 99. 


the "ENTER ACTION CODE:" prompt, 
exit from the SP-STATUS display, 


Each action code and 


sections. 


equivalent spooler verb is described in the following 


See Figure A for a sample screen layout which would follow the execution of the 
SP-STATUS verb. 
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FORM QUEVE ASSIGNMENT 


QUEUE FORM DEVICE DEVICE DEVICE NUMBER PAGE 
NAME TYPE ASSIGNED TYPE STATUS ENTRIES SKIP 


STANVARD 1-PART LPTR ACTIVE 

CHECK PAYROLL TAPE NOT READY 
LIST-T 0 NO DEVICE 
LABEL MAIL PORT ASSIGNED 
SAMPLE LPTR ASSIGNED 
PAYABLES LPTR NO DEVICE 


. . ry 


ACTION CODES 
1. CREATE FORM QUEUE 4. CHANGE DEVICE ASSIGNMENT 7. DELETE FORM QUEUE 
2. CHANGE FORM QUEUE 5. CHANGE PAGE SKIP 8. PAGE EJECT 
3. CHANGE FORM TYPE 6. LIST PRINT JOBS 99. EXIT 


ENTER ACTION CODE: 


Figure A. Sample Screen Display of SP-STATUS Verb 
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8.7 Spooler Output Devices 


The spooler can output print jobs to three types of devices: a line printer, a 


tape unit, and a terminal port. 


Line Printer 


{The spooler may support a maximum of four line printers. Each printer is 
assigned a device number; this may be a number from 1 to 4. When the system 
is initialized, the default form queue STANDARD is assigned to printer #1. 


Tape Unit 


When a job is spooled to tape, the output is written to the magnetic tape unit 
starting wherever the tape is currently positioned. The tape unit is rewound 
by the spooler only when the end of a reel is reached; thus, jobs may be 
spooled to tape one after another. You must mount the tape (with write ring), 
place the unit on-line, and rewind or position the tape prior to using the 
spooler. 


Caution should be used when spooling to tape while some other user is using the 
tape drive (a status of “NEED DEV"). The spooler will wait for the tape to 
become available before attempting to write. If the other user rewinds the 
tape and detaches it, the spooler will gain control of the tape and start 
writing the spooled output. 


Normally the spooler writes unlabeled tape jobs consisting of 500-byte records. 
However, if the “N° option is in effect, the records will be of varying length 
and each record will terminate at the end of a print line closest to 500 bytes. 
In other words, the records will be split at line boundries if the “N” option 
is in effect, rather than at the 500th character. This is useful when taking 
spooled reports to other devices that must have full lines within records. 


Terminal Port 
The spooler may spool output to any port if assigned to a queue. Any number of 
these ports may be attached to CRT terminals or serial printers. Note: You 


May not assign Port Zero as a spooler port. 


Figure A listed the terms used to represent the three types of spooler output 
devices and a brief description of each. 
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Device 


Type 


LPTR 


Legal 
Device# 
Brief Explanation Range 


Line Printer; spooler supports 1-4 
a maximum of four. 


Magnetic Tape Unit; spooler 
supports a maximum of one. 


Terminal Port; spooler supports 
as many ports as the system 
configuration allows. 


Figure A. Terms Used to Define Spooler Output Devices 
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8.8 Creating a Form Queue 


A form queue is created by the execution of either the SP-STATUS Action Code 


(Create Form Queue) or the SP-CREATE verb. 


The general form of the Create Form Queue Action Code is: 


ENTER ACTION CODE 


FORM-QUEVE DEVICE-TYPE(LPTR,TAPE,PORT) DEVICE#: 


where: 


FORM-QUEUE 


DEVICE-TY PE 


DEVICE# 


is prompting for a form queue name. This name must be less 
than or equal to 20 alphabetic, numeric, or special 
characters (asterisks and embedded spaces are not allowed). 


Note: a form queue name may not be a single numeric 
character. 


is prompting for one of the following: 


Type Explanation 


LPTR Line Printer 
TAPE Tape Drive 
PORT Terminal Port 
0 No Device 


is prompting for the number assigned to the output device. 
Each system printer is assigned a device number from 1 to 
4, The tape unit is device 1, 2, 3, or 4, depending on the 
number of drives on the system. A port device may have a 
device number up to the maximum number of ports on the 
systen. 


Each prompt response must be separated by one space. Figure A illustrates the 
use of the SP=STATUS Action Code 1. 
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FORM QUEVE ASSIGNMENT 


QUEUE FORM DEVICE DEVICE DEVICE NUMBER PAGE 
NAME TYPE ASSIGNED TYPE STATUS ENTRIES SKIP 


STANDARD 1-PART 1 LPTR ACTIVE 7 0 
CHECK PAYROLL L TAPE NOT-READY 1 0 
LIST-T 0) ) NO DEVICE 0 0 
LABEL MAIL 2 PORT ASSIGNED 0 0 
SAMP LE 3 LPTR ASSIGNED 0 0 
PAYABLES 0 LPTR NO DEVICE 1 0 


ACTION CODES 
Ll. CREATE FORM QUEUE 4. CHANGE DEVICE ASSIGNMENT 7. DELETE FORM QUEUE 
2. CHANGE FORM QUEUE 5. CHANGE PAGE SKIP 8. PAGE EJECT 

3. CHANGE FORM TYPE 6. LIST PRINT JOBS 99. EXIT 


ENTER ACTLON CODE The Create Form Queue 
FORM~QUEUE DEVICE-TYPE(LPTR, TAPE, PORT) Aetton Code produces the 


DEVICE#: form queue PART which te 
assigned to printer #2. 


Figure A. Sample Usage of the Create Form Queue Action Code 
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The general form of the SP-CREATE verb is: 
SP-CREATE form-queue device-type device# 


The device number and device type may both be "0" (zero). In this case, the 
form queue is created but no print jobs are output. A device is assigned to 
the queue by either the SP-STATUS Action Code 4 (Change Device Assignment) or 
the SP-DEVICE verb (refer to the section CHANGING DEVICE ASSIGNMENT). If you 
create a queue and assign it to a device that is already assigned to a queue, 
the message: 


A QUEUE IS ALREADY ASSIGNED TO THIS DEVICE 
OK TO CHANGE? 


is displayed. If you enter "N", your queue will be created without a device 
assignment. If you enter "Y", the print job currently being output on the 
selected device will be completed, and your queue will have a status of 
"WAITING", When the job is complete, the device is reassigned to the queue 
you created, and the previously assigned queue has a status of "NO DEVICE", 


Figure B illustrates the use of the SP-~CREATE verb. Figure C displays a 


sample SP-STATUS screen which would appear following the execution of the 
example in Figure A or B. 
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The SP-CREATE verb performs 


the same funetton as Aetton 
code 1. 


Figure B, Sample Usage of SP+CREATE Verb 


FORM QUEUE ASSIGNMENT 


QUEUE FORM DEVICE DEVICE DEVICE NUMBER PAGE 
NAME TYPE ASSIGNED TYPE STATUS ENTRIES SKIP 


STANDARD 1-PART LPTR ACTIVE 


CHECK PAYROLL TAPE NOT READY 
LIST-T 0 NO DEVICE 
LABEL MAIL PORT ASSIGNED 
SAMPLE LPTR ASSIGNED 
PAYABLES LPTR NO DEVICE 
PART LPTR ASSIGNED 


Figure C. Sample SP-STATUS Screen Display 
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8.9 Changing the Name of a Form Queue 


The name of a form queue may be changed by the’ execution of either the 


SP-STATUS Action Code 2 (Change Form Queue) or the SP-FORM verb. 


The format of the Change Form Queue Action Code is: 


ENTER ACTION CODE 
OLD-NAME NEW-NAME: 


where “OLD-NAME" and "NEW-NAME" are prompts specifying the order of the required 
response. 
The format of the SP-FORM verb is: 


SP-FORM old-name new-name 


Action Code 2 and the SP-FORM verb both change the name of an already 
established form queue. Tne new queue name remains in effect until another 
name is entered by one of these two methods. 


You may change the name of STANDARD; however, the queue itself remains as_ the 
default form queue. 


Figure A and B illustrate the use of the Change Print Action Code and the 


SP-FORM verb. Figure C displays the SP-STATUS screen which would follow the 
execution of the example in Figure A or B. 
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FORM QUEUE ASSIGNMENT 


QUEUE FORM DEVICE DEVICE DEVICE NUMBER PAGE 
NAME TYPE ASSIGNED TYPE STATUS ENTRIES SKIP 


STANDARD 1-PART LPTR ACTIVE 
CHECK PAYROLL TAPE NOT READY 
LIST-T 0 NO DEVICE 
LABEL MAIL PORT ASSIGNED 
SAMPLE : LPTR ASSIGNED 
PAYABLES LPTR NO DEVICE 
PART d LPTR ASSIGNED 


ACTION CODES 
L. CREATE FORM QUEUE 4. CHANGE DEVICE ASSIGNMENT 7. DELETE FORM QUEUE 
2. CHANGE FORM QUEUE 5. CHANGE PAGE SKIP 8. PAGE EJECT 
3. CHANGE FORM TYPE 6. LIST PRINT JOBS 99. EXIT 


ENTER ACTION CODE . 7 The Change Form Queue Action 
OLD-NAME NEW-NAMi : : Code alters the name of form 
queue STANDARD to INVOICES. 


Figure A. Sample Usage of Change Form Queue Action Code 


The SP=-FORM verb is performing 
the same funetion as Action 
Code 2 above. Notice that you 
must enter "SP-STATUS" to get 
screen display. 


Figure B. Sample Usage of SP-FORM Verb 


FORM QUEUE ASSIGNMENT 


QUEUE FORM DEVICE DEVICE DEVICE NUMBER PAGE 
NAME TYPE ASSIGNED TYPE STATUS ' ENTRIES SKIP 


INVOICES 1-PART LPTR ACTIVE 


CHECK PAYROLL TAPE NOT READY 
LIST-T 0 NO DEVICE 
LABEL MAIL PORT ASSIGNED 
SAMPLE LPTR ASSIGNED 
PAYABLES LPTR NO DEVICE 
PART LPTR ASSIGNED 


Figure C. SP-STATUS Screen Display 
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%.10 Changing Type of Form Used on Printer 


The SP-STATUS Action Code 3 (Change Form Type) and the SP-TYPE verb allow you 
to specify a form type for each queue. This form type will be displayed on the 


SP-STATUS screen and serves to remind you of the type of form required on the 
assigned device. 


The format of the Change Form Type Action Code is: 


ENTER ACTION CODE 
FORM-QUEUE FORM 


where: 
FORtM-QUEUE is prompting for the name of the form queue assigned to the 
printer. 
FOKM-TYPE is prompting for the name of the form to be placed on the 
printer. 


The format of the SP-TYPE verb is: 


SP-TYPE form-queue form-type 


Note that the terms "FORM-QUEUE" and “FORM-TYPE" refer to two different 
elements of a form queue. The form queue is associated with devices, not 
necessarily with the type of forms. There may be a large number of uniquely 
defined form queues. It is possible to change the form type without changing 
the name of the form queue because the "form-type” is not used by the spooler. 
It is intended only as a reminder to you of the type of form that should be on 
the specified device. 


Figure A and B illustrate the use of the Change Form Type Action Code and the 
SP-TYPE verb. Figure C displays the SP-STATUS screen which would follow the 
execution of the example in Figure A or B. 
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FORM QUEUE ASSIGNMENT 


QUEUE FOR: DEVICE DEVICE DEVICE NUMBER PAGE 
NAME TYPE ASSIGNED TYPE STATUS ENTRIES SKIP 


INVOICES L-PART 1 LPTR ACTIVE 7 0) 
CHECK PAYROLL 1 TAPE NOT READY 1 0 
LIST-T 6) 0 NO DEVICE Q 0) 
LABEL MAIL 2 PORT ASSIGNED ) 0 
SAMPLE 3 LPTR ASSIGNED 0 0 
PAYABLES 0 LPTR NO DEVICE 1 0 
PART 2 LPTR ASSIGNED 0 6) 


ACTION CODES 
L. CREATE FORM QUEUE 4. CHANGE DEVICE ASSIGNMENT 7. DELETE FORM QUEUE 
2. CHANGE #ORM QUEUE 5. CHANGE PAGE SKIP 8. PAGE EJECT 

3. CHANGE FORM TYPE 6. LIST PRINT JOBS 99. EXIT 


ENTER ACTION CODE:3 ex 
FURM-QUEUE FORM-TYPE 


The Change Form Type Action 
Code changes the form type 
of form queue INVOICES to 
INVOICE. 


Figure A. Sample Usage of Change Form Type Action Code 


This SP-TYPE verb performs 


the same funetton ae the 
action code in Figure A. 


Figure B. Sample Usage of SP-TYPE Verb 


FORM QUEUE ASSIGNMENT 


QUEUE FORM DEVICE DEVICE DEVICE NUMBER PAGE 
NAME TYPE ASSIGNED TYPE STATUS ' ENTRIES SKIP 


INVOICES INVOICE 1 LPTR ACTIVE 

CHECK PAYROLL 1 TAPE NOT READY 
LIST-T 0 0 NO DEVICE 
LABEL MAIL 2 PORT ASSIGNED 
SAMPLE 3 LPTR ASSIGNED 
PAYABLES 0) LPTR NO DEVICE 
PART 2 LPTR ASSIGNED 


Figure C. SP-STATUS bisplay Screen 
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8.11 Changing Device Assignments 


A device assignment may be changed by either the SP-STATUS Action Code 


(Change Device Assignment) or the SP-DEVICE verb. 


The general form of the Change Device Assignment Action Code is: 


ENTER ACTLON CODE 
FORM-QUEUE DEVICE 


TYPE(LPTR,TAPE,PORT) DEVICE#: 


The format of the SP-DEVICE verb is: 
SP=DEVICE form-queue device-type device# 


Changing a device assignment is especially useful when a printer is idle but 
there are several form queues waiting to be printed. In this case, you may 
assign the idle printer to a form queue waiting to be printed. 


In general, there may be only one queue assigned to each device at any time. 
For example, should you attempt to assign Form Queue B to LPTR 2 and this 
device is already assigned to Form Queue A, you are asked if such a device 
reassignment is permissible. If permission is granted to change the device 
assignment, a stop order is issued to Form Queue A and its assignment to LPTR 2 
will be cancelled as soon as the current job has been printed. Form Queue B 
will acquire a “WAITING” status until Form Queue A is finished printing; Form 
Queue B will then be assigned to LPTR 2. 


The range of legal device numbers is given in the topic titled “SPOOLER OUTPUT 
DEVICES". If the device number specified is not within range, the following 
message will appear: 


INVALID DEVICE# RANGE. 

NOTE: The spooler has no way of knowing which devices are physically present. 
It is your responsibility to ensure that the device number specified is 
actually present on the system. 

Figure A and B illustrate the use of the Change Device Assignment Action Code 


and the SP-DEVICE verb. Figure C displays the SP-STATUS screen which would 
follow the execution of the example in Figure A or B. 


138 83-1109 


& SPOOLER 


FORM QUEUE ASSIGNMENT 


QUEUE FORM DEVICE DEVICE DEVICE NUMBER PAGE 
NAME TYPE ASSIGNED TYPE STATUS ENTRIES SKIP 


INVOICES INVOICE LPTR ACTIVE 
CHECK PAYROLL TAPE NOT READY 
LIST-T ( 0 NO DEVICE 
LABEL MAIL PORT ASSIGNED 
SAMPLE LPTR ASSIGNED 
PAYABLES LPTR NO DEVICE 
PART y LPTR ASSIGNED 


ACTION CODES 
lL. CREATE FORM QUHUE 4. CHANGE DEVICE ASSIGNMENT 7. DELETE FORM QUEUE 
2. CHANGE FORM QUEUK 5. CHANGE PAGE SKIP 8. PAGE EJECT 
3. CHANGE FORM TYPE 6. LIST PRINT JOBS 99. EXIT 


ENTER ACTION CODE: : The Change Device Asstgn- 
FORM-QUBUE DEVICE-TYPE(LPTK, TAPE, PORT) ment Action Code assigns 
DEVICE#: PAYABLES LPT! : form queue PAYABLES to 
printer #1. 
A QUEUE iS ALREADY ASSIGNED TO THIS DEVICE A response of 'Y' permite 
OK TO CHANGE the device reasstgnment. 


Figure A. Sample Usage of Change Device Assignment Action Code 


The SP-DEVICE verb performe 
the same function as Action 


Code 7 in Figure A. 


Figure B. Sample Usage of SP-DEVICE Verb 


FORM QUEVE ASSIGNMENT 


QUEUE FORM DEVICE DEVICE DEVICE NUMBER PAGE 
NAME TYPE ASSIGNED TYPE STATUS ENTRIES SKIP 


INVOICES INVOICE NO DEVICE 


CHECK PAYROLL NOT READY 
LIST-T- NO DEVICE 
LABEL MAIL ASSIGNED 
SAMPLE : ASSIGNED 
PAYABLES ACTIVE 
PART ASSIGNED 


Figure C. . SP-STATUS Screen Display 
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8.12 Deleting a Form Queue 


A form queue may be deleted by use of either the SP-STATUS Action 


(Delete Form Queue) or the SP-FQDELETE verb. 


The format of the Delete Form Queue Action Code is: 


ENTER ACTION CODE 
FORM-QUEUE: 


where "“FORM-QUEUE" is prompting for the name of the queue to be deleted. 


The format of the SP-FQDELETE verb is: 

SP-FQDELETE form-queue 
A form queue’ may only be deleted if it has no jobs queued for output and there 
are no lines assigned to it. The default form queue (STANDARD) may not be 
deleted. 
Figure A and B illustrate the usage of the Delete Form Queue Action Code and 


the SP-FQDELETE verb. Figure C displays the SP-STATUS screen which would 
follow the execution of the example in Figure A or B. 
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FORM QUEUE ASSIGNMENT 


QUEUE FORM DEVICE DEVICE DEVICE NUMBER PAGE 
NAME TYPE ASSIGNED TYPE STATUS ENTRIES SKIP 


INVOICES INVOICE LPTR ACTIVE 
CHECK PAYROLL TAPE NOT READY 
LIST-T 0 NO DEVICE 
LABEL MAIL é PORT ASSIGNED 
SAMPLE : LPTR ASSIGNED 
PAYABLES LPTR NO DEVICE 
PART y LPTR ASSIGNED 


ACTION CODES 
i. CREATE FORM QUEUE 4. CHANGE DEVICE ASSIGNMENT 7. DELETE FORM QUEUE 
2. CHANGE FORM QUEUE 5. CHANGE PAGE SKIP 8. PAGE EJECT 
3. CHANGE FORM TYPE 6. LIST PRINT JOBS 99. EXIT 


ENLER ACTION CODE:; The Delete Form Queue Actton Code removes the 
FORM-YUEUE—NAME : LIST-T queue from the queue table. 


Figure A. Sample Usage of Delete Form Queue Action Code 


The SP-FQDELETE verb performe the same funetton 
as the actton code in Figure A. 


Figure 8. Sample Usage of SP-FQDELETE Verb 


FORM QUEUE ASSIGNMENT 


QUEUE FORM DEVICE DEVICE DEVICE NUMBER PAGE 
NAME TYPE ASSIGNED TYPE STATUS ENTRIES SKIP 


INVOLCES INVOICE LPTR ACTIVE 
CHECK PAYROLL TAPE NOT READY 
LABEL MAIL PORT ASSIGNED 
SAMPLE LPTR ASSIGNED 
PAYABLES LPTR NO DEVICE 
PART LPTR ASSIGNED 


Figure C. Sample SP-STATUS Screen Display 
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%.13 Ejecting Pages from Printer 


To alter the number of pages ejected from the printer after exhausting each 
form queue, use the SP-STATUS Action Code 5 (Change Page Skip) or the SP-SKIP 


verb. To tell an attached printer to eject a specified number of pages at your 
command, use SP-STATUS Action Code 8 (Page Eject) or the SP-EJECT verb. 


The format of the Change Page Skip Action Code is: 


ENTER ACTION CODE 
FORM-QUEUE PAGES: 


where: 
FORM-QUEUE is prompting for the name of the queue assigned to the 
printer. 
PAGES is prompting for the number of pages to be ejected. 


The format of the SP-SKIP verb is: 

SP-SKIP form-queue pages 
The maximum number of pages the printer may eject after exhausting a print 
queue is 10. answering the "PAGES" prompt with a number greater than 10 
results in the following message: TOO MANY PAGES. 


The format of the Page Eject Action Code is: 


ENTER ACTION CODE 
FORM-QUEUE PAGES 


The format of the SP-EJECT verb is: 
SP-EJECT form-queue pages 


Action Code 8 and the SP-EJECT verb attach the assigned printer to your line 
and issue a number of page ejects to that printer. (Note that page ejects are 
not shown on the SP-STATUS display.) The printer remains attached to the 
terminal until you issue a P-DET or SP-ASSIGN verb or you log off. See topic 
entitled PRINTER CONTROL: P-ATT and P-DET for a detailed explanation of the 
P-DET command. 


If you attempt to eject more than 10 pages, the following message appears: TOO 
MANY PAGES. 


Figure A and 5 illustrate the usage of Change Page Skip Action Code and the 
SP-SKIP verb. Figure C displays the SP-STATUS screen that would follow the 
execution of the example in Figure A or B. Sample usage of the Page Eject 
Action Code and the SP-EJECT verb is seen in Figure D and E. 
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FORM QUEUE ASSIGNMENT 


QUEUE FORM DEVICE DEVICE DEVICE NUMBER PAGE 
NAME TYPE ASSIGNED TYPE STATUS ENTRIES SKIP 


INVOICES INVOICE LPTR ACTIVE 

CHECK PAYROLL TAPE NOT READY 
LABEL MAIL PORT ASSIGNED 
SAMPLE LPTR ASSIGNED 
PAYABLES LPTR NO DEVICE 
PART LPTR ASSIGNED 


ACTION CODES 
1. CREATE FORM QUEUE 4. CHANGE DEVICE ASSIGNMENT 7. DELETE FORM QUEUE 
2. CHANGE FORM QUEUE 5. CHANGE PAGE SKIP 8. PAGE EJECT 
3. CHANGE FORM TYPE 6. LIST PRINT JOBS 99. EXIT 


ENTER ACTION CODE s 
FORM-QUEUE PAGES: 


The Change Page Skip Aetion Code alters 
the Page Skip funetton from 0 to 2. 


Figure A. Sample Usage of Change Page Skip Action Code 


The SP-SKIP verb performs the same 
function as Aetion Code 5 in Figure A. 


Figure B. Sample Usage of SP-SKIP Verb 


FORM QUEUE ASSIGNMENT 


QUEUE FORM DEVICE DEVICE DEVICE NUMBER PAGE 
NAME TYPE ASSIGNED TYPE STATUS ENTRIES SKIP 


INVOICES INVOICE LPTR ACTIVE 
CHECK PAYROLL TAPE NOT READY 
LABEL MATL PORT ASSIGNED 
SAMPLE LPTR ASSIGNED 
PAYABLES LPTR NO DEVICE 
PART LPTR ASSIGNED 


Figure C. SP-STATUS Screen Display 


The Page Ejeet Action Code causes the 


ENTER ACTION CODE 
FORM-QUEUE PAGES 


printer assigned to SAMPLE to eject 4 
pages. 


Figure D. Sample Usage of Change Page Eject Action Code 


The SP=-EJECT verb performs the same 
function as Action Code 8 in Figure D. 


Figure E. Sample Usage of SP-EJECT Verb 
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8.14 Displaying Print Job Status: SP-JOBS 


The SP-STATUS Action Code 6 (List Print Jobs) and the SP-JOBS verb display the 


current status of print jobs within each form queue. 


The format of the List Print Jobs Action Code is: 


ENTER ACTION CODE / PAGE NUMBER (P#)? 


This action code evokes the same screen display as the SP-JOBS verb which is 
described below. 


The format of the SP-JOUBS verb is: 
SP-JOBS 


The SP-JOBS verb displays: 1) name of the form queue, 2) the print job number 
assigned to spooled jobs, 3) name of account from which print job was created, 
4) the terminal line number from which the print job originated, 5) the date 
the print job was created, 6) status of the print job, 7) the options chosen, 
&) the number of frames each print job occupies, and 9) number of copies to be 
printed. 


The job status will be one of the following: 


OPEN A user process is writing to the job. 

WALT The job is closed and waiting to be printed. 
PRINT The job is being printed. 

FINISH The job has been printed. 


At any given time, more than one of the status conditions listed above may 
exist; however, only one status condition will be displayed. The display 
priority is: FINISH, PRINT, WAIT, OPEN. 


If there are no print jobs assigned to any form queues and the SP-JOBS verb is 
executed, the message "THE QUEUE IS EMPTY" will be displayed on the screen. 


The action codes listed below immediately follow the screen displays of the 
SP-JOBS verb: 


1. MOVE FORM QUEUE 5. DELETE JOB 9. SUSPEND PRINTING 
2» MOVE PRINT JOBS 6. STOP PRINTING 10. CHANGE PRIORITY 
3. CHANGE OPTIONS 7. RESUME PRINTING ll. SP-STATUS 

4, CHANGE #0F COPIES 8. EDIT PRINT JOB 99. EXIT 
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If you wish to execute an action code, enter its corresponding number in 
response to the prompt “ENTER ACTION CODE / PAGE NUMBER (P#)?". As soon as an 
action code is executed, an updated SP-JOBS screen is displayed. To page 
through the SP-JOBS screen(s), press the RETURN key. However, if you wish to 
skip to a particular page of the SP-JOBS screen, enter a "P", followed by a 
page number. For example, if you enter a "P22" to the "ENTER ACTION CODE / 
PAGE NUMBER (P#)?" prompt, all jobs listed on page 22 appear on the screen. 
Should you enter a number larger than the number of SP-JOBS pages, an error 
message appears and you are reprompted. 


To display the SP-STATUS screen, enter Action Code ll. To exit the display 
screen, enter Action Code 9Y. 


The SP-JOBS action codes are explained in the following sections. Figure A 
illustrates the format of the SP-JOBS verb; Figure B is a sample screen 
display which follows the execution of the SP-JOBS verb. 


SP-JOBS 


Figure A. Format of the SP-JOBS Verb 


PRINT JOBS 


PRINT DATE 
QUEUE NAME JOB ACCOUNT LINE CREATED STATUS OPT SIZE COPIES 


INVOICES 
INVOICES 
INVOICES 
CHECK 
SAMPLE 
INVOICES 
INVOICES 
INVOICES 


ACT 
ACT 
MANF 
PERS 
PROD 
MANF 
ACT 
MANF 


AUG PRINT 
AUG WAIT 
AUG OPEN 
AUG WAIT 
AUG WAIT 
AUG WAIT 
AUG WAIT 
AUG WAIT 
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MOVE FORM QUEUE DELETE JOB SUSPEND PRINTING 
MOVE PRINT JOB STOP PRINTING CHANGE PRIORITY 
CHANGE OPTIONS RESUME PRINT SP-STATUS 

CHANGE #0F COPIES EDIT PRINT JOB EXIT 


ENTER ACTION CODE / PAGE NUMBER (P#)? 


Figure B. Sample SP-JOBS Screen Display 
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8.15 Moving a Form Queue 


To transfer all print jobs in one queue to a different queue, enter the SP-JOBS 


Action Code 1 (Move Form Queue) or the SP-MOVEQ verb. 


The general form of the Move Form Queue Action Code is: 


ENTER ACTION CODE / PAGE NUMBER (P#)? 
FROM-FORM-QUEUE TO-FORM-QUEUE: 
PASSWORD: 


where: 


FROM-FORM-QUEUE is prompting for the name of the current form queue. 


TO-FORM-QUEUE is prompting for the name of the form queue accepting 
the print jobs. 
PASSWORD: is prompting for the password of the account which 


created the form queue. If the account has no password 
or the password is the same as' the current account, you 
are not prompted for the password. 


The format of the SP-MOVEQ verb is: 
SP-MOVEQ from-form-queue to-form-queue 
If the printing of a form queue has been "killed" by the SP-KILL verb before 
the execution of the Move Form Queue Action Code or the SP-MOVEQ verb, the 
interrupted job and all subsequent jobs in the queue will be moved. 
NOTE: Print jobs having a status of "FINISH" are not moved. Use Action Code 2 
(Move Print Job) or SP-SWITCH to move such a job to another form queue 
(see the topic MOVING PRINT JOBS" for more information). 
Figure A and B illustrate the use of the Move Form Queue Action Code and 


SP-MOVEQ verb. Figure C displays the S$P-JOBS screen which would follow the 
execution of the example in Figure A or Figure B. 


146 83-1109 


38 SPOOLER 


PRINT JOBS 


PRINT DATE 
QUEUE NAME JOB ACCOUNT LINE CREATED STATUS OPT SIZE COPIES 


INVO1CES 
INVOICES 
INVOICES 
CHECK 
SAMPLE 
INVOICES 
INVOICES 
INVOICES 


ACT 
ACT 
MANF 
PERS 
PROD 
MANF 
ACT 
MANF 


No} 


AUG PRINT H 
AUG WAIT H 
AUG OPEN H 
AUG WAIT 
AUG WAIT 
AUG WAIT 
AUG WAIT 
AUG WAIT 
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MOVE FORM QUEUE DELETE JOB - SUSPEND PRINTING 
- MOVE PRINT JOB STOP PRINTING 10. CHANGE PRIORITY 

CHANGE OPTIONS RESUME PRINTING li. SP-STATUS 

CHANGE #0F COPIES EDIT PRINT JOB 99. EXIT 


ENTER ACTION CODE / PAGE NUMBER (P#)? The Move Form Queue Action Code 
FROM=FORM-QUEUK TO-FORM-QUEUE: moves all print jobs from form 
queue SAMPLE to CHECK. 


Figure A. Sample Usage of Move Form Queue Action Code 


Thts SP-MOVEQ verb performs the 
same funetiton as Aetion Code 1 
in Figure A. 


Figure B. Sample Usage of SP-MOVEQ Verb 


PRINT JOBS 


DATE 
QUEUE NAME ACCOUNT LINE CREATED STATUS OPT SIZE COPIES 


INVOICES 
INVOICES 
INVOICES 
CHECK 
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ACT 
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Figure C. SP-JOBS Screen Display 
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8.16 Moving Print Jobs 


The SP-JU8S Action Code 2 (Move Print Job) and the SP-SWITCH verb transfer one 


print job or a list of print jobs to another queue. 


The general form of the Move Print Job Action Code is: 


ENTER ACTION CODE / PAGE NUMBER (P#)?: 
NEW-FORM-QUEUE PRINT-JOB-LIST: 


PASSWOKD: 
where: 
NEW~F ORM-QUEUE is prompting for the name of the form queue accepting 
the print job(s). 
PRINT-JOB-LIST is prompting for the number of each print job to be 
moved. Each print job number is separated by one 
space. 


The format of the SP-SWITCH verb is: 
SP-SWITCH new-form-queue print-job-list 


A job currently being printed cannot be moved to a new queue unless the Suspend 
Printing Action Code or the SP-SUSPEND verb has been issued to the current form 
queue. When the job is moved, it will be reprinted from the beginning of the 
job. 


Figure A and B illustrate the use of the Move Print Job Action Code and the 


SP=SWLTCH verb. Figure C displays the SP-~JOBS screen which would follow the 
execution of the example in Figure A or B. 
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PRINT JOBS 


PRINT DATE 
QUEUE NAME JOB AUCOUNT LINE CREATED STATUS OPT SIZE COPLES 


INVOICES l ACT 9 12 AUG PRINT H 12 1 
INVOICES 2 ACT 2 12 AUG WAIT H 15 1 
INVOICES 3 MANF 3 12 AUG OPEN H 7 1 
CHECK 4 PERS 5 12 AUG WALT 27 1 
CHECK 5 PROD 25 12 AUG WAIT HS 30 1 
INVOLCES 6 MANF 3 12 AUG WAIT H 15 1 
INVOICES 7 ACT 2 12 AUG WAIT H 9 1 
INVOICES 8 MANF 10 12 AUG WAIT H 27 1 
1. MOVE FORM QUEUE 5. DELETE JOB . 9. SUSPEND PRINTING 
2. MOVE PRINT JOB 6. STOP PRINTING 1O. CHANGE PRIORITY 
3. CHANGE OPTIONS 7. RESUME PRINTING ll. SP-STATUS 
4. CHANGE #OF COPIES 8. EDI’ PRINT JOB 99. EXIT 


ENTER ACTION CODE / PAGE NUMBER (P#)?; 
WEW-FORM-QUEUE PRINT~JUB-LIST 


The Move Print Job Action Code 
moves print job #2 in INVOICES 
form queue to PART form queue 
(prevtously created by 
SP-STATUS Actton Code 1). 


Figure A. Sample Usage of Move Print Job Action Code 


This SP-SWITCH verb performs 
the eame funetton as Action 
Code 2 in Figure A. 


Figure B. Sample Usage of SP-SWITCH Verb 


PRINT JOBS 


PRINT DATE 
QUEUE NAME JOB ACCOUNT LINE CREATED STATUS OPT SIZE COPIES 
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Figure C. SP-JOBS Screen Display 
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8.17 Changing Print Job Options 


To change print job options, use the SP-JOBS Action Code 3 (Change Options) or 


the SP-OPTS verb. 


The general form of the Change Options Action Code is: 


ENTER ACTION CODE / PAGE NUMBER (P#) 
PRINT-JOB# OPTIONS: 


where: 

PRINT-JOB# is prompting for the number of the print job. 

OPTIONS is prompting for one or both of the symbols used to 

indicate those options that can be changed. 

The format of the SP-OPTS verb is: 

SP-OPTS print-job# options 
By using this verb, previous options are deleted and new options are assigned 
to the print job. The options that may be changed are “H” (hold print job 
until deleted) and “S” (suppress output). 
The options of a currently outputting job cannot be changed. If the “OPTIONS” 
prompt is answered with a <cr> only, the previous options are cancelled and the 
print job is left with no options. 
Figure A and B illustrate the use of the Change Options Action Code and the 


SP-OPTS verb. Figure C displays tne SP-JOBS screen that would follow the 
execution of the example in Figure A or B. 
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PRINT JOBS 


PRINT DATE 
QUEUE NAME JOB ACCOUNT LINE CREATED STATUS OPT SIZE COPIES 


INVOICES 
PART 
INVOLCES 
CHECK 
CHECK 
INVOICES 
INVOICES 
LNVOICES 


ACT 
ACT 
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MANF 
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MANF 
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AUG WAIT 
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1. MOVE FORM QUEUE DELETE JOB 9. SUSPEND PRINTING 
2. MOVE PRINT JOB 9. STOP PRINTING LQ. CHANGE PRIORITY 
3. CHANGE OPTIONS » RESUME PRINTING ll. SP-STATUS 

4. CHANGE #0F COPIES EDIT PRINT JOB 99. EXIT 


ENTER ACTION CODE / P 31 i? The Change Opttons Aetton Code 
PKINT-JOB# OPTIONS adde the 'H' and 'S' opttone to 
print job #4. 


Figure A. Sample Usage of Change Options Action Code 


Thie SP-OPTS verb performs the 


same function as Actton Code 3 
in Figure A. 


Figure B. Sample Usage of SP-OPTS Verb 


PRINT JOBS 


PRINT DATE 
QUEUE NAME JOB ACCOUNT LINE CREATED STATUS OPT SIZE COPIES 
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Figure C. SP-JOBS Screen Display 
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8.18 Changing Number of Print Job Copies 


Use the SP-JOBS Action Code 4 (Change Number of Copies) or the SP-COPIES 


to alter the number of times a print job is printed. 


The general form of the Change Number of Copies Action Code is: 


ENTER ACTION CODE / PAGE NUMBER (P#)? 
PRINT-JOB# COPLES: 


where: 
PRINT-JOB# is prompting for the number of the print job whose 
"copies" parameter is to be changed. 
COPIES is prompting for the number of copies (1 - 100) to be 
printed. 


The format of the SP-COPIES verb is: 

SP-COPLES print-job-# copies 
Execution of either of these two methods replaces the current “copies” 
parameter of a job waiting to be printed or a hold file that has been printed. 
The “copies” parameter of a currently printing job cannot be changed. 
Figure A and B illustrate the use of the Change Number of Copies Action Code 


and the SP-COPIES verb. Figure C displays the SP-JOBS screen which would 
follow the execution of the example in Figure A or B. 


152 83-1109 


8 SPOOLER 


PRINT JOBS 


PRINT DATE 
QUEUE NAME JOB ACCOUNT CREATED STATUS SIZE COPIES 
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1. MOVE FORM QUEUE 5. DELETE JOB 9. SUSPEND PRINTING 
2. MOVE PRINT JOB 6. STOP PRINTING 10. CHANGE PRIORITY 

3. CHANGE OPTLONS 7. RESUME PRINTING ll. SP-STATUS 
4. CHANGE #0F COPIES 8. EDIT PRINT JOB 99. EXIT 


ENTER ACTION CODE / PAGE NUMBER (P#) Thts Change #of Coptes Action Code 

PRINT~JOB# COPIES: deletes the "1" copy destgnatton 
for print job #4 and replaces it 
with "3", 


Figure A. Sample Usage of Change Number of Copies Action Code 


Thts SP-COPIES verb performs the 
same funetion as Aetion Code 4 in 
Figure A. 


Figure B. Sample Usage of SP-COPIES Verb 
PRINT JOBS 
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Figure C. SP-JOBS Screen Display 
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%.19 Deleting Print Jobs from a Queue 


The SP-JOBS Action Code 5 (Delete Job) or the SP-DELETE verb removes print jobs 


from a form queue. 


The general form of the Nelete Job Action Code is: 


ENTER ACTION CODE / PAGE NUMBER (P#)?5 
PRINT-JOB-LIST: 
PASSWORD: 


where: 


PRINT-JOB-LIST: is prompting for the print job numbers to be deleted. 
Each number is separated by one space. 

PASSWORD: is prompting for the password of the account from which 
the print job was created. 


The format of the SP-DELETE verb is: 


SP-DELETE print-job-list 
PASSWORD: 


After deleting a job, the overflow frames are returned to the system. A 
currently outputting print job may be deleted only if all queve output is 
killed and the queve is inactive. An open print job cannot be deleted until 
the job is closed and the job is placed in a “WAIT” or “FINISH” state. 


If all print jobs do not have the same password, you will be prompted when a 
new password is needed. 


Figure A and B iliustrate the use of the Delete Job Action Code and the 


SP-DELETE verb. Figure C displays the SP~JOBS screen which would follow the 
execution of the example in Figure A or B. 
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PRINT JOBS 


PRINT DATE 
QUEUE NAME JOB ACCOUNT CREATED STATUS SIZE COPIES 


INVOICES ACT 
PART ACT 
INVOICES MANF 
CHECK PERS 
CHECK PROD 
INVOICES 6 MANF 
INVOICES ACT 
INVOICES MANF 


AUG PRINT 
AUG PRINT 
AUG OPEN 
AUG WAIT 
AUG WAIT 
AUG WAIT 
AUG WAIT 
AUG WAIT 


Nw 
ONWUuUwoOWhrK 
FPRPrPrPWrr Ee 


— 


1. MOVE FORM QUEUE « DELETE JOB 9. SUSPEND PRINTING 
2. MOVE PRINT JOB STOP PRINTING 10. CHANGE PRIORITY 
3. CHANGE OPTIONS RESUME PRINT 11. SP-STATUS 

4. CHANGE #0F COPIES EDIT PRINT JOB 99. EXIT 


ENTER ACTION CODE / PAGE NUMBER (P#)?5 <er> Thies Delete Job Action Code elim- 
PRIWT-JOB : tnates print job #5 found tn the 
PASSWORD: CHECK form queue and returne the 30 
frames the job used to overflow. 


Figure A. Sample Usage of Delete Job Action Code 


This SP-DELETE verb performs the 
same function as Action Code 5 tn 
Figure A. 


Figure B. Sample Usage of SP-DELETE Verb 


PRINT JOBS 


PRINT DATE 
QUEUE NAME JOS ACCOUNT LINE CREATED STATUS OPT SIZE COPIES 


INVOICES ACT AUG PRINT H 
PART ACT d AUG PRINT H 
INVOICES MANF 2 AUG OPEN H 
CHECK PERS AUG WAIT H 
INVOICES MANF : AUG WALT H 
INVOICES ACT é AUG WAIT HB 
INVOICES MANF H 


AUG WAIT 


Figure C. SP-JOBS Screen Display 
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3.20 Stopping the Printer Before or After Printing a Job 


The SP-JOBS Action Code 6 (Stop Printing) and the SP-STOP verb may be used to 


stop the printer just after the printing of the current print job or just 
before the printing of a specified print job. 


The general form of the Stop Printing Action Code is: 


ENTER ACTION CODE / PAGE NUMBER (P#) 
FORM-QUEUE OR PRINT-JOB#: 


where: 


FORM-QUEUE is prompting for the name of the queue whose printing will 
be halted. 


PRINT-JOB-# is prompting for the number of the print job whose printing 
will be delayed. 
The format of the SP-STOP verb is: 
SP-STOP form-queue or print-job# 
If you wish to stop the printer just after the current job is printed, enter 
the name of the active form queue. Should you decide to stop the printer 


before printing a specified job, enter the number of that print job. 


When you stop the printer prior to printing a specific job, all jobs in the 
queue will be printed until the specified job is encountered. 


Figure A and 8 illustrate the use of the Stop Printing Action Code and the 


SP-STOP verb. Figure C displays the SP-STATUS display that reflects the 
interruption to the INVOICES form queue. 
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PRINT JOBS 


PRINT DATE 
QUEUE NAIMtH JOB ACCUUNT LINE CREATED STATUS OPT SIZE COPIES 


INVOICES ACT AUG PRINT 


PART ‘ Ac? AUG PRINT 
INVOICES : MANF : 2 AUG 


12 
15 
7 


INVOICES MANF AUG 
INVOICES ACT AUG 
INVOICES MANF 2 AUG 


15 
9 
27 


H 
H 
H 
CHECK PERS AUG HS 27 
H 
ul 
H 


1. MOVE FORM QUEUE DELETE JOB 9. SUSPEND PRINTING 
2. MOVE PRINT JOB - STOP PRINTING 10. CHANGE PRIORITY 
3. CHANGE OPTIONS RESUME PRINTING ll. SP-STATUS 

4. CHANGE #0F COPIES EDIT PRINT JOB 99. EXIT 


ENTER ACTION CODE / PAGE NUMBER (P#)?6 <er> This Stop Printing Actton Code stops 
FORM-QUEUE OK PRINT-JOB#: the printer prior to printing job 


e 


Figure A. Sample Usage of Stop Printing Action Code 


Thts SP-STOP verb performs the same 
function as Aetton Code 6 in Figure 
A. 


Figure 8. Sample Usage of SP-STOP Verb 


FORM QUEUE ASSIGNMENT 


QUEUE FORM DEVICE DEVICE DEVICE NUMBER PAGE 
NAME TYPE ASSIGNED TYPE STATUS ENTRIES SKIP 


INVOICES INVOICE LPTR STOP 
CHECK PAYROLL TAPE NOT READY 
LABEL MAIL PORT ASSIGNED 
SAMPLE : LPTR ASSIGNED 
PAYABLES LPTR NO DEVICE 
PART LPTR ACTIVE 


rFoocco + 


Figure C. SP-STATUS Screen Display 
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8.21 Restarting a Printer After a Forced Wait 


Restarting a printer after a forced wait is accomplished by the SP-JOBS Action 


Code 7 (Resume Printing Action Code) or the SP-RESUME verb. 


The general form of the Resume Printing Action Code is: 


ENTEK ACTLON CODE / PAGE NUMBER (P#) 
FORM-QUEUE : 


where: 


FORM-QUEJUE: is prompting for the name of the interrupted form queue. 


The format of the SP-RESUME verb is: 


SP-RESUME form-queue 


One of these two methods must be used after correcting the problem responsible 
for a device status of NEXT REEL, PARITY or CABLE OFF, and may be used after 
the execution of Suspend Printing and Stop Printing Action Codes or SP-SUSPEND 
and SP-STOP verbs. 


When the SP-RESUME or the Resume Printing Action Code is executed, printing 
will begin where the spooler left off. 


Figure A and B illustrate the use of the Stop Printing Action Code and the 


SP-RESUME verb. Figure C displays the SP-STATUS screen which reflects the 
"ACTIVE" status of form queue INVOICES. 
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PRINT JOBS 


PRINT DATE 
QUEUE NAME JOB ACCOUNT LINE CREATED STATUS OPT SIZE COPIES 


INVOLCKS ACT AUG FINISH H 
PART y ACT AUG He 
INVOICES : MANF 2 AUG H 
CHECK. PERS AUG H 
H 
H 
H 


INVOICES MANF AUG 
INVOICES AcT AUG 
INVOICES 5 MANF 1 2 AUG 


L. MOVE FORM QUEUE 5. DELETE JOB 9. SUSPEND PRINTING 
2. MOVE PRINT JOB 6. STOP PRINTING 10. CHANGE PRIORITY 
3. CHANGE UPTIONS 7. RESUME PRINTING ll. SP-STATUS 

4, CHANGE #OF COPIES 8. EDIT PRINT JOB 99. EXIT 


ENTER ACTION CODE / PAGE NUMBER (P#)? This Resume Printing Action 
FORM-QUEUE Code starts the printing of 
. job #6 whieh was interrupted 
by Aetton Code 6 in prevtous 

section. 


Figure A. Sample Usage of Resume Printing Action Code 


Thie SP-RESUME verb performs 


the same funetton as Actton 
Code 7 in Figure A. 


Figure 8. Sample Usage of SP-RESUME Verb 


FORM QUEUE ASSIGNMENT 


QUEUE FORM DEVICE DEVICE DEVICE NUMBER PAGE 
NAME TYPE ASSIGNED TYPE STATUS ENTRIES SKIP 


INVOICES INVOICE l LPTR ACTIVE 4 2 
CHECK PAYROLL L TAPE NOT READY 0 0 
LABEL MALL 2 PORT ASSIGNED 0 0 
SAMPLE 3 LPTR ASSIGNED 0 0 
PAYABLES 0 LPTR NO DEVICE 0 0 
PART 2 LPTR ACTIVE 1 0 


Figure C. SP-STATUS Screen Display 
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8.22 Interrupting a Printing Job 


The SP-JOBS Action Code 9 (Suspend Printing) and the SP-SUSPEND verb interrupt 
the printing of the current print job but do not delete the job from the queue. 


The SP-KILL verb also halts the output of the current print job and deletes 
that job if it is not a hold file. 


The format of the Suspend Printing Action Code is: 


ENTER ACTION CODE / PAGE NUMBER (P#) 
FORM-QUEUE --OR-- DEVICE# TYPE 


FORM-QUEUE is prompting for the name of the interrupted 
form queue. If you enter the form queue name, 
do not enter device# and type. 


DEVICE# TYPE is prompting for the device number and type of 
assigned device. The form queue name is not 
necessary if you enter the device number and 
type. 


The format of the SP-SUSPEND verb is: 


SP-SUSPEND form-queue -~or-- device# and type 


When either of these two methods is initiated, the interruption to the printing 
job is immediate. To restart printing where the spooler left off, use Action 
Code 7 (Resume Printing) or the SP-KESUME verb. To resume printing at any 
location you wish, issue the “P* command of the Edit Print Job Action Code and 
the SP-EDIT verb. 


The format of the SP-KILL verb is: 
SP-KILL form-queue --or-- device# and type 


When the SP-KILL verb is executed, the currently printing job is halted and the 
next job in the queue begins printing immediately. If the interrupted job is a 
hold file, it will remain in the job list; if the job is not a hold file, it 
-will be deleted. 


Figure A and B illustrate the use of the Suspend Printing Action Code and the 
SP-SUSPEND verb. Figure C displays the SP-STATUS screen which would follow the 
execution of the example in Figure A or B. An SP-JOBS screen is not shown here 
because the actual queue status can only be seen on the SP-STATUS display. 
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PRINT JOBS 


PRINT DATE 
QUEUE NAME JOB ACCOUNT CREATED STATUS OPT SIZE COPIES 


INVOICES ACT AUG FINISH 4H 
PART ACT AUG H 
INVOICES MANF AUG H 
CHECK PERS AUG HS 
H 
H 
H 


INVOICES MANF 2 AUG 
INVOICES ACT 2 2 AUG 
INVOICES MANF AUG 


1. MOVE FORM QUEUE DELETE JOB 9. SUSPEND PRINTING 
2. MOVE PRINT JOB » STOP PRINTING 10. CHANGE PRIORITY 
3. CHANGE OPTIONS RESUME PRINTING ll. SP-STATUS 

4. CHANGE #0F COPIES EDIT PRINT JOB 99. EXIT 


ENTER ACTIUN CODE / PAGE NUMBER (Pi)? = Thie Suspend 


Printing 
FORM-QUEUE --OK-- DEVICE# TYPE: 


Actton Code tnterrupts 
the printing of print job 
#6. 


Figure A. Sample Usage of Suspend Printing Action Code 


This SP-SUSPEND verb per- 
forme the same funetion as 
Aettion Code 9 in Figure A. 


Figure B. Sample Usage of SP-SUSPEND Verb 


QUEUE FORM DEVICE DEVICE DEVICE NUMBER PAGE 
NAME TYPE ASSIGNED TYPE STATUS ENTRIES SKIP 


INVOICES INVOICE LPTR SUSPEND 


CHECK PAYROLL TAPE NOT READY 
LABEL MAIL PORT ASSIGNED 
SAMPLE if LPTR ASSIGNED 
PAYABLES d LPTR NO DEVICE 
PART LPTR ACTIVE 


Figure C. SP-STATUS Screen Display 


83-1109 . Lei: 


8 SPOOLER 


8.23 Examining Jobs Waiting to be Printed 


The SP-JOBS Action Code 8 (Edit Print Job) and the SP-EDIT verb manipulate a 


print job for display, forms alignment and/or printing a previously interrupted 
print job. 


Yhe general form of the Edit Print Job Action Code is: 


ENTER ACTION CODE / PAGE NUMBER (P#) 
PRINT-JOB#: 

PASSWORD: 

*ENTER COMMAND: 


where: 
PRINT-JOB#: is prompting for the number of the print job to be 
edited. 
PASSWORD: is prompting for the password of the account from which 


the job was created. If you do not know the password, 
press RETURN until you get back to TCL. 


*ENTER COMMAND: is prompting for the command to be executed. 


The format of the SP-EDIT verb is: 
SP-EDIT print-—job# 


PASSWORD: 
*ENTER COMMAND: 


These two methods allow the use of the following commands: 


Command Explanation 
L{n} List "n" lines. 
L{n} “string” Locate “string” in next "n" lines. 
P Print to the end of the job. 
Bim} Backward postioning "m" pages. 
F{m} Forward positioning “m" pages. 
A{n} Alignment of “n" lines in 

masked form. 
T Top of report. 
EX Exit. 


These commands are detailed in the following sections. 


Figure A and B illustrate the use of the Edit Print Job Action Code and the 
SP-EDIT verb. Figure C shows illustrates sample usage of each edit command. 
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ENTER ACTION CODE / PAGE NUMBER (P#)? the Edit Print Job Action Code 


PRINT-JOB# displays the firet 22 Lines of 
PA SSWORD: ¥ print job #4. 


Figure A. Sample Usage of Edit Print Job Action Code 


: This SP-EDIT command causes 
PA SSWORD: : Print Job #5 to be printed 
*ENTER COMMA from beginning to end. 


Figure B. Sample Usage of SP-EDIT Verb 


*ENTER COMMAND Liste first 26 lines. 
*ENTER COMMAND Locates "SIZE" in next 8 lines. 


‘ENTER COMMAND Printe the entire job starting from the 
current Line postition. 


*ENTER 7 Places current line postition back 5 pages. 


*ENTER Places current line position forward 10 
pages. 


*ENTER Aligne next 7 lines in masked form. 


-*kENTER Sets current line position to top of job. 


Figure C. Edit Command Formats 
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8.24 Edit Print Job Commands: List and Locate 


The following two commands list and locate specified lines within a print job. 


LIST "n'' LINES 


The general form of this command is: 
L{n} 
where "n' specifies number of lines. 


This command lists a specified number of lines beginning from the current line 


position displayed on the terminal. If "n" is not specified, only one line is 


displayed on the screen, and the current print position is set at the next 
line. 


Should a listing display more than one page, each "TOP OF FORM" will be seen on 
the screen. 


Note: You should be aware of the current print position because subsequent 
EDIT commands are based on this position. 


LOCATE A STRING 
The general form of this command is: 


Li{n}"string" 


where: 
n specifies the number of lines to be searched. 
string specifies the string to be located. 


This command changes the current print position to the line that contains the 
character string specified in the command. If "n" is omitted, the entire print 
job is searched. If "n" is entered, the search is conducted within the 
specified number of lines. Any non-numeric delimiter may be used (where double 
quotes are shown above) to specify the character string as long as _ the 
delimiter itself is not part of the string. 
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ENTER ACTION COD ms PAGE NUMBER (P#) 
PRINT-JOB-#34 
*ENTER COMMAND: 


PAGE 1 7/14/83 
H.S. Smith 

78129 

F.D. Brown 

59217 

b.D. Silver 

61298 

R.M. Henderson 


Print Job #4 te about to be edtted. 


The firet 10 ltnes wilt be lteted 
on the screen. 


—_————_—__—-—_—_————-———— The next 5 lines will be searched 


P.S. MENDELSON 
51367 

H.T. WELLS 

7 


for the string "SMITH". 
g 


The next 5 Lines whteh follow 
"RLM. SMITH" will be displayed. 


The next 10 lines will be searched 
for the string "CORTEZ". The cur- 
rent print posttton ts now set at 
the 31st line. 


Figure A. Sample Usage of the List and Locate Commands 
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8.25 Edit Print Job Commands: Backward, Forward Positioning and Top 


The Backward Positioning command moves the print position back a specified 
number of pages; the Forward Positioning command moves the print position 


forward a specified number of pages; the Top of Print Job command sets the 
print position at the top of the current job. 


BACKWARD POSITIONING 

The general form of this command is: 
B{m} 

where "m' specifies the number of pages. 


This command controls the current print position. Positioning is set "m" pages 


backward from the current print position. If "m' is omitted, positioning is 


set at the top of the current print page. If "m'' is greater than the number of 


previous pages, the position is set to the top of the print job. 
FORWARD POSITIONING 
The general form of this command is: 
F{m} 
where "m'' specifies the number of pages. 
This command moves the current print position forward "m" pages. If "m" is 
omitted, the position is moved to the top of the next print page. If "m" is 
greater than the number of remaining pages, the print position is set at the 
end of the job (EOF). 
TOP OF PRINT JOB 
The general form of this command is: 


T 


This command positions the current print position to the top of the print job. 
A "TOP" message is displayed following the execution of this command. 
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ENTER ACTION CODE / PAGE NUMBER (P#) 
PRINT-JOB-#: 7? 
*ENTER COMMAND: 


PAGE 1 07/14/82 
H.S. SMITH 

78129 

F.D. BROWN 

59217 

DD. SILVER 

61298 

R.«M. HENDERSON 


07/14/82 


07/14/82 


07/14/82 


07/14/82 


07/14/82 


Print Job #7 te about to be edited. 


The first 10 Lines of print job #7 
are listed. 


Current Line position its moved to 
top of Page 3. 


The firet line of Page 3 is listed. 


Current Line position ts set at the 
top of Page 2. 
First line of Page 2 te listed. 


Current line posttton te set at the 
line following the string "PAGE 3". 
Current Line postition is rolled 
back to the top of Page 3. 


Current line posttion ts rolled 
forward 3 pages. 
First line of Page 6 te listed. 


Current line posttton ts set to top 
of job. 


Figure Ae Sample Use of Backward and Forward Positioning and Top Commands 
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8.26 Edit Print Job Commands: Alignment, Print and Exit 


The Alignment command outputs to a printer the specified number of lines in 
masked form; the Print command begins output at the current line position and 


printing continues until the entire job is printed; the Exit command leaves 
the print job entirely. 


ALIGNMENT 
The general form of this command is: 


A{n} 


where "n" specifies the number of lines to be aligned on a printer. If "n" is 
not specified, the entire page is printed in masked form. Note that this 
command cannot be sent to a terminal port. 


wasking is performed as follows: 

X represents any alphanumeric character 

9 represents any numeric character 

All punctuation characters remain the same. 
The current line position is set at the next line. 
PRINT LINES 
The format of this command is: 
P 

This command enables you to print a job. Printing begins at the current line 
position; therefore, you must first establish the current line position by 
using a List, Locate, Top, Forward or Backward command. Printing will then 
continue until the entire job is printed. 
This command may also be used to restart a "suspended" job. The Editor is 
automatically exited by the Print command and the suspended status of the queue 


is cleared. 


EXIT 


Tne EXIT command format is: 
EX 
This command allows you to exit from the print job. 


Figure A illustrates the use of Alignment, Print and Exit Commands. Figure B 
displays the SP-STATUS screen that would appear after restarting print job #6. 
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ENTER ACTION CODE / PAGE NUMBER (P#) Print Job #6 ts about to be 

PRINT=JOB#: edited. 

*ENTER COMMAN —_—_—_——_—_—_____—_——_-—— The first 3 lines of print job 
#6 are ltsted. 

PAGE 1 01/15/81 

ABCE 1256 CD 

12123 


SS SS ene ner 2 Linge are ourpuL to 
the assigned device in masked 
form for alignment. In this 
example, 


XXXK 9999 XX 
99999 
XXXX 9999 XX 
99999 


would be printed. 
—_—_____——————————-_ Current line position is set 


to top of job. 


SS ee NE NEL Ye: Brine GOD ote OunpuUr 
to asetgned device. 


Figure A. Sample Usage of Alignment, Print and Exit Commands 


QUEUE FORM DEVICE DEVICE DEVICE NUMBER PAGE 
NAME TYPE ASSIGNED TYPE STATUS ENTRIES SKIP 


INVOICES INVOICE 1 LPTR ACTIVE 

CHECK PAYROLL 1 TAPE NOT READY 

LABEL MATL 2 PORT ASSIGNED 

SAMPLE 3 LPTR ASSIGNED 

PA YA BLES 0 LPTR NO DEVICE 
2 


LPTR ACTIVE 


re OOOO & 


PART 


Figure B. SP-STATUS Screen Display 
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8.27 Changing Priority of Print Jobs 


The position of a print job within a queue may be changed by either the SP-JOBS 


Action Code 10 (Change Priority) or the SP-PRIORITY verb. 


The format of the Change Priority Action Code is: 


ENTER ACTLON CODE / PAGE NUMBER (P#) 
PRINT-JOB#: 


where: 

PRINT-JOB#: is prompting for the number of the print job whose 

placement in the queue is to be changed. 

The format of the SP-PRIORITY verb is: 

SP-PRIORITY print—job# 
Both of the above-mentioned methods alter the printing priority of jobs within 
a form queue. The job priority is changed by moving the specified print job to 
’ the top of the queue. The printing of this job commences immediately after the 
current job is printed. 
Figure A and B illustrate the usage of the Change Priority Action Code and the 


SP-PRIORITY verb. Figure C displays the SP-JOBS screen which would follow the 
execution of the example in Figure A or B. 
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FORM QUEUES 


QUEUE PRINT DATE 
NAME JOB CREATED STATUS SIZE COPIES 


INVOICES AUG FINISH 4H 
PART y AUG PRINT H 
LNVOICES 2 AUG OPEN H 
CHECK AUG WAIT HS 
INVOICES : AUG PRINT H 
INVOICES 2 AUG WAIT H 
INVOICES AUG WAIT H 


1. MOVE FORM QUEUE DELETE JOB SUSPEND PRINTING 
2. MOVE PRINT JUb - STOP PRINTING CHANGE PRIORITY 
3. CHANGE OPTIONS RESUME PRINTING SP-STATUS 

CHANGE #U0F COPIES EDIT HOLD JOB 99. EXIT 


ENTER ACTION CODE / PAGE NUMBER (P#)? The Change Prtority Action 

PRINT-JOB# : Code moves job #8 to the top 
of the form queue and ite 
printing wtll begtn 
immedtately after print job #6 
ts printed. 


Thts SP-PRIORITY verb performs 
the same function as Actton 
Code 10 in Figure A. 


Figure B. Sample Usage of SP-PRIORITY Verb 


FORM QUEUES 


QUEUE PRINT DATE 
NAME JOB CREATED STATUS OPT SIZE COPIES 


INVOICES ; 2 AUG FINISH 


PART AUG PRINT 
INVOICES AUG OPEN 
CHECK AUG WAIT 
INVOICES AUG FINISH 
INVOLCES 12 AUG WAIT 
INVOICES AUG PRINT 


Figure C. SP-JOBS Screen Display 
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8.28 TCL Control of Ports: SP-PORTON PROC 


The SP=PORTON PROC starts the process which designates a port as available for 


spooler output. 


The general form of the SP-PORTON PROC is: 


SP-PORTON line# --or-- line# form-queue 
SP=PORTON line# trans-code --or-- line# form-queue trans-code 


If you enter SP-PORTON <cer>, the system will respond with prompts for the 
required parameters, where: 


line# specifies the line to be used as a spooler port 

form-queue specifies the name of the queve the print job(s) are 
assigned to. If the form queue name is entered, you 
must also enter the line number. 


trans=code a translation code of 3 causes all spooler jobs to be 
translated to the new matrix printer commands before 
despooling. 


The SP=PORTON PROC logs on a port as an available device for spooler output. A 
PORT device cannot output print jobs until the SP-PORTON PROC is executed. 
Once SP=PORTON is executed, the attached device (which can be a CRT terminal, 
serial character printer or other device) can be controlled by spooler verbs. 


The line# may be any port number (the maximum number of ports is determined by 
the current system configuration), or it may be an asterisk (#*), which 
specifies that print jobs will be sent to the terminal which originated the 
SP=PORTON PROC. Port zero cannot be used as a spooler port, 


Currently, only translation code 3 is allowed. This code translates spooled 
output created for the old matrix printer into the proper characters used by 
the new matrix printer. User programs that spool data with the old matrix 
printer commands need not be modified for use with the new matrix printer if 
the port is set up for trans=code 3. A program directly utilizing the new 
commands in spooled output should not use a translation code. 


If a port process is initiated on the line on which it is going to run, it is 
considered a "normal" process, and can be interrupted by the <BREAK> key. If 
SP-PORTON is initiated from another line with or without the optional queue 
name, it is a TIPH phantom process. If a queue name is specified, it will be 
used as the TASK ID of the TIPH process. See the chapter titled TERMINAL 
INDEPENDENT PROCESS HANDLER (TIPH) for a detailed explanation of TIPH. 


NOTE 


Do not log off an SP=PORTON line. Use the SP-PORTOFF verb 
to terminate an SP=PORTON assignment. 
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There are four conditions under which the SP=PORTON PROC may be used: 
Condition #1 


Form queue TEST is created and assigned to a "terminal" device type (no device 
number assigned) prior to executing SP-PORTON. Subsequent use to the 
SP=-PORTON PROC with the queue name TEST causes the print jobs to be output to 
the specified port. The SP=STATUS display reflects a new line number in the 
"DEVICE ASSIGNED" column. 


Co tion #2 


Form queue RECPTS is created without a device or device number assigned prior 
to executing SP-PORTON. The use of SP-PORTON with the queue name RECPTS 
automatically assigns that queue to the specified port, and all print jobs 
assigned to form queue RECPTSare sent to that port. The SP-STATUS display 
reflects a new line number in the "DEVICE ASSIGNED" column and a "PORT" 
designation in the "DEVICE TYPE" column. 


Figure A illustrates Condition #1 and Condition #2. 
Condition #1 


Thts SP-CREATE verb creates form queue 
PAYROLL which te asstgned to a port but no 
device Line number ts destgnated. 


All future print jobs assigned to PAYROLL 
will be hold files. 


The two ENGLISH reporte become hold files 
asstgned to form queue PAYROLL. 


The SP-PORTON PROC causes both hold files in 
PAYROLL to be output to port line #25. 
TASK PAYROLL STARTED ON LINE 25 


Condition #2 


the SP-CREATE verb produces form queue PROD 
without a device assignment. 


The SP-PORTON PROC assigns port #4 to PROD. 


He 


TASK PROD STARTED ON LINE 4 


ALL future print jobe will be assigned to 
PROD and spooled to port #4. 


Figure A, Sample Usage of SP=PORTON PROC 
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Condition #3 


A form queue does not exist. First, the SP-PORTON PROC is executed. Next, 
the form queue is created with a port device number. The use of SP=PORTON 
without a form queue name specified activates the port process, which waits 
until a form queue is created with the same device number as the port line 
number, The SP-STATUS display reflects the device designation only after the 
form queue is created. 


Condition #4 


Form queve INVS has been assigned to a port that has a line number assigned 
prior to executing SP-PORTON. The use of SP=PORTON first activates the port 
process, which will then find the matching device number assigned to the port. 
The associated print job is output to the device on the specified port. The 
SP-STATUS display reflects the device assignment. 


Figure B illustrates Condition #3 and Condition #4. 
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Condition #3 


> + The SP-PORTON PROC ts executed before the 
< form queue te created. 
TASK STARTED ON LINE 15 


The SP-CREATE verb produces the form queue 
INVENTORY which ts assigned to port line 
#16. 


Condition #4 


This SP-CREATE verb produces the RECEIPTS 
form queue which te asstgned to port Line 
#50 e 


The SP-PORTON PROC activates the port 
process on line #80. The asterisk its 

TASK STAKTED ON LINE 30 entered because the operator te currently 
using port #80. 


Figure B, Sample Usage of SP-PORTON PROC 


83-1109 (REV 6/84) 175 


8 SPOOLER 


8.29 TCL Control of Ports: SP=-PORTOFF Verb 


The SP-PORTOFF verb may log off an SP-PORTON line before or after output is 


finished. 


The general form of the SP-PORTOFF verb is: 
SP-PORTOFF form—queue=name --or-- line# 
OR 


SP-PORTOFF <er> 
ENTER LINE# --OR-- FQ-NAME: 


where: 
form-queue-name specifies the name of the form queue that was assigned 
to the port 
line# specifies the line used as the spooler port 


An asterisk (*) cannot be specified as a "line number", All form queue names 
must begin with either an alphabetic or a special character (except *), If the 
first character is numeric, it is treated as a "line number", If SP-PORTOFF is 
used before output is finished, SP-PORTON may be used to restart the port 
process, Output will begin at the first line of the job. 


Figure A illustrates sample usage of the SP=-PORTOFF Verb. 
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+ The SP-PORTOFF verb terminates the use of 
Line 30 asa spooler port (see Conditton 
#4). 


<cr>—t———- If the previous SP-PORTOFF verb terminated 
the port process before the job was 
completed, the SP-~PORTON PROC wtll 
reactivate the port process. Output begins 
on the firet line of the job. 


Figure A. Sample Usage of SP-PORTOFF Verb 
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8.30 Printer Control: P-ATT and P-DET 


The P-ATT verb attaches your terminal line to the specified printer. The P-DET 


verb detaches your terminal line from the specified printer. 


The P-ATT verb has the following general form: 


P-ATT {form-queue-name or device#} 


where: 
form-queue-name specifies the name of the queue assigned to the 
desired printer. 
device specifies the printer number (which can be a number 


from 1 through 4). If no parameters are given, 
printer #1 is attached. 


If you are already attached to the printer, only the TCL prompt is returned. 
If the printer is attached to another line, the following message is displayed 
on the screen: 

LPTR ATTACHED TO LINE n. 
where "n' represents the user’s line number (or spooler process) the printer is 
attached to. If the attachment is successful, the following message is 
displayed: 

LPTR ATTACHED. 
The format of the P=DET verb is: 

P-DET {form-queue-name or device#} {(U)} 


The P=DET verb releases printer attachment, but only if your line is currently 
attached to the printer. Otherwise, the following message is displayed: 


{655] NOT ATTACHED! 
Users with SYS2 privileges may use the unconditional form (i-e., P-DET (U)). 
This will detach the printer from any line except the spooler (which detaches 
automatically when the queue is empty). An attempt to use this form without 
SYS2 privileges, or an attempt to detach the printer from the spooler, will 
lead to the following message: 


[660] INSUFFICIENT PRIVILEGES OR DEVICE ATTACHED TO SPOOLER. 
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P-ATT {form-queue-name or device#} 


attaches printer 


P-DET {form—queue-name or device#} {(U)} 
detaches printer spectfies unconditional detach 
(for SYS2 privtleged usere only) 


Figure A.» General Form of P-ATT and P-DET Verbs 


EXAMPLES EXPLA NATION 
Attaches printer #1 (default printer). 
Attaches printer assigned to form queue INVOICES. 
Detaches printer asstgned to user. 


Detaches printer assigned to form queue PAYROLL. 


Detaches printer #4, even tf attached to another 
Line (for SYS2 privileged users only). 


ALL user spooler assignments are cleared and all 
devices attached for 'N' option output are cleared. 
Subsequent print jobs wtll be dtrected to the 
STANDARD form queue. 


Figure B. Sample Usage of P-ATT and P=DET Verbs 
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8.31 Tape Control: T-ATT, I-DET and SP-TAPEOUT Verbs and T-PRINT PROC 


The T-ATLr and T-DET verbs attach and detach the tape unit. Further magnetic 


tape unit control is provided by the T-PRINT PROC and the SP-TAPEOUT verb. 


The T-ATT verb has the following format: 
T-ATT {n} {Coptions) } 


fhe T-ATT verb attaches your line to the magnetic tape unit where "n" 
represents a tape block size (see chapter titled MAGNETIC TAPE UNIT COMMANDS). 
If "n" is omitted, a default block size of 512 bytes is assumed. Options are 
described in Chapter 9. If the tape unit is attached to another line, the 
message “TAPE ATTACHED TO LINE n" is displayed. 


If attachment is successful, this message is displayed: [92] TAPE ATTACHED, 
RECORD SIZE = n. 


The yveneral form of the T-DET verb is: 
T-DET {(U)} 


Tne T-DEIT verb releases tape unit attachment, but only if the your line is 
currently attached to the tape unit. Otherwise, the message "[655] NOT 
ATTACHED!" is displayed. 


Users with SYS2 privileges may use the unconditional form (i.e., T-DET (U)). 
This detaches the tape unit from any line except the spooler (which detaches 
automatically at the end of each job). An attempt to use this form without 
SYS2 privileges, or an attempt to detach the tape unit from the spooler will 
lead to the following message: [660] INSUFFICIENT PRIVILEGES OR DEVICE 
ATTACHED TO SPOOLER. 


NOTE: Use the unconditional form of the T-DET verb with caution. This verb 
should not be executed while another user is outputting to tape. 


The T-PRINT PROC has the following general form: 
T-PRINT {"string"”} 


This is a PROC which uses as input a reel of magnetic tape previously created 
by spooling to tape. When T-PRINT is entered, the following steps are 
performed: 


1. The tape unit is attached. 

2. The magnetic tape is rewound to the load point. 

3. The tape is searched for the "string" (if used). 

4. Output of the report proceeds from the tape to the designated printer. 
Printing begins with the first line which contains the "string". 

5. The tape is still attached to the line after T-PRINT is done. 
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The general form of the SP-TAPEOUT verb is: 
SP=TAPEOUT {"string"} 


This verb is used by the T=PRINT PROC. No device assignment is altered and no 
tape rewind is done. This verb can be used to build custom PROCs requiring 
tape jobs to be spooled. The next job on the magnetic tape is spooled 
according to the user’s current SP-ASSIGN options. 


The verbs T-ATT, T-DET, T-PRINT and SP-TAPEOUT are summarized in Figure A. 
Examples of these verbs are shown in Figure B. 


TATT {(n} {(options) }—«— Attaches magnetite tape unit. 


T-DET {(U) }~———_—__—- Detaches magnetic tape unit. 'U' speciftes 
uneondttional detach (for SYS2 privileged usere 
only). 


T~PRINT {"string"}««——- Tape and printer are attached, tape rewound, and 
line-at-a-time printing begins with firet 
occurrence of opttonal "string". 


SP-TAPEOUT {"string"}—*— Wext tape job ts spooled according to current 
SP-ASSIGN opttons, etarting with firet Line 
containing opttonal "string". 


Figure A» Format of T-ATT, T-DET AND SP-TAPEOUT Verbs and T-PRINT PROC 


EXAMPLE EXPLANATION 


<—_—____. Attaches tape unit. Default record stze of 512 
bytes ie assigned. 


~<~—————— Detaches tape untt. 


t+ Detaches tape untt even tf attached to another 
line (for SYS2 privileged users only). 


+ Tape unit and printer are attached, tape unit ts 
rewound, and line-at-a-time printing begins with 
firet line containing string "XYZ123". 


~<t———- Next job on tape ie spooled. 


Figure B. Sample Usage of T-ATT, T-DET and SP-TAPEOUT Verbs and T-PRINT PROC 
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8.32 Spooler Activation: :RESTART-SPOOLER and :SP-NEWTAB Verbs 


The spooler is automatically activated during job restore process. For further 
information regarding this process, refer to Chapter 11, SYSTEM MAINTENANCE 
PROCEDURES. The spooler may also be restarted with the :RESTART-SPOOLER verb; 


should :RESTART-SPOOLER fail, :SP-NEWTAB may be used to reinitialize the 
spooler, 


The spooler may be activated under the following two conditions: 1) print jobs 
and queue data in use are retained by the spooler, and 2) print jobs and queue 
data are lost to the system. 


The first condition occurs after a system restore with an "X" or “A" option, a 
Binary Restore, or after the :RESTARI-SPOOLER verb is used. The spooler 
retains the addresses of its tables and all open print jobs are closed; 
therefore, no queue data or print jobs are lost. 


The :RESTART-SPOOLER verb should only be used when neither the printer or tape 
unit is attached to a user”s line and when no line is generating a spooled job. 
This verb may be used in an emergency situation such as a spooler abort. (The 
spooler has aborted if the message "SPOOLER ABORTED. RESTART BEING ATTEMPTED." 
appears on the SP-STATUS display.) 


The second condition occurs after a system restore with an “X“, “A”, “F” or 
“AF” restore and after the verbs :FILES, :ABS/FILES, and :SP-NEWTAB are used. 
Under such circumstances, all spooler tables and jobs are lost, including hold 
jobs, and the tables are reinitialized. 
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9.1 Magnetic Tape Units 


This chapter discusses the use of magnetic tape units, and the associated 


verbs, The system can accommodate up to four tape units. 


The verbs which will be discussed in this chapter are: 


T-ATT 
ASSIGN 
CLEAR-ASSIGN 
T=DET 
T-FWD 
T-BCK 
T-REW 
T-WEOF 
T=CHK 
TREAD 
T=DUMP 
ST-DUMP 
T-LOAD 
MT=LOAD 
MT-VERIFY 
T-RDLBL 
T-COPY 


This chapter will also discuss tape unit sequencing for multiple tape units, 
tape labels, and multiple reel tape operations. 
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9.2 Magnetic Tape Unit Sequencing 


This section discusses magnetic tape unit sequencing during tape operations. 


The system will begin operations with the tape unit that is first in the 
unit-list of the channel being used. It will use the units associated with 
the channel in the order they are specified in the unit-list. When the system 
reaches the end of the list, it returns to the beginning. When a tape is 
finished, the tape is rewound and the unit is put off-line, If the drive is 
ready when the system returns to use it again, the system will assume that a 
new tape has been mounted and will continue with the tape operation. If the 
drive is not ready, the prompt: 


MOUNT REEL # n ON DRIVE m 
TYPE 'Ct TO CONTINUE 


will be displayed. 
When the system finishes a tape operation, it will "remember" the unit it 


finished on, and subsequent operations on the channel will begin with this 
unit. 
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9.3 T-ATT Verb 


The T-ATT verb attaches the magnetic tape unit to the terminal that issued the 


command and assigns a record size. 


‘The general form of the T-ATT verb is: 

T-ATT {n} 

where "n" is the record size 
The system will automatically attach tape unit 1. To attach other tape units, 
use the ASSIGN verb, The T-ATT verb must be issued before the tape unit is 
used. If it is not, the message: 

NO SUCH TAPE ASSIGNMENT EXISTS 
is displayed. When the tape unit is attached, the message: 


DEVICE(S) TAPE 1 NOW ASSIGNED, 
RECORD SIZE = n 


is displayed, where "n™ is the record size that was attached. When the tape 
is attached, other users are not able to access it. If you attempt to attach 
the tape when it is already attached to a user, the message: 

DEVICE TAPE n IS ASSIGNED TO LINE m 
is displayed, where "m" is the line number the tape unit is attached to. 
The magnetic tape unit is automatically detached when you log off the system. 


Examples of the use of the T-ATT verb are provided in Figure A. 


Record Size 


The record size may be from 20 to 32,256 bytes. If a record is not specified 
with the T-ATT verb, the default size of 8190 is used. 


Tape labels generated by the system contain the record size. If the tape is 
positioned at a label and the record size specified with the T-ATT verb is 
less than the record size contained in the label, the system automatically 
uses the size contained in the label. The change in record size is indicated 
by the message: 

TAPE SIZE CHANGED TO n 


where 'n" is the size obtained from the tape label. 
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If the tape is not positioned at a label, the system uses the record size 
specified with the T-ATT verb. If the attached size is smaller than the 
actual size, the record is truncated at the size specified with the T-ATT 
verb. 


:T-ATT <er> No record size specified -= 
[1021] DEVICE(S) TAPE 1 NOW ASSIGNED, default size used. 
RECORD SIZE = 8190 


:T-ATT 2048 <cr>d 
[1021] DEVICE(S) TAPE 1 NOW ASSIGNED, 
RECORD SIZE = 2048 


Tape was attached with a 
record size of 2048 bytes. 


Figure A, Sample usage of the T-ATT Verb 
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9.4 ASSIGN Verb 


The ASSIGN verb allows you to assign a unit list and a record size to a 


specified channel. This verb attaches the unit(s) assigned. 


The general form of the ASSIGN verb is: 

ASSIGN specification {;specification}... 

where "specification" has the general form of: 

{channel}=TAPE {unit-list} {SIZEssize} 

"Channel", if present, is any alphabetic character from A to Z. If a channel 
is not specified, all existing assignments are destroyed, and the unitelist 
and record size specified are assigned to the default channel. If a channel 
is specified and the default channel exists, the default channel is destroyed, 
The ability to associate a channel name with a logical tape unit allows you to 
create applications and command streams which refer to channels by name. 
The general form of "unit-list" is: 

unit {,unit}... 

where "unit" is 1, 2, 3, or 4. 
"Unit-list" must be present. A unit may not be assigned to two channels at 
the same time, and may not appear more than once in a list. If a unit in the 
list has already been assigned to another channel, the message: 

DEVICE TAPE n ASSIGNED TO THIS LINE, BUT FOR ANOTHER CHANNEL 


is displayed, and the channel assignment is not changed. 


"Size", if present, is a record size between 20 and 32,256. The default size 
is 8190. 
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:ASSIGN =TAPE 3 
{1021] DEVICE(S) TAPE 3 NOW ASSIGNED, 
RECORD SIZE = 8190 


:ASSIGN A=TAPE 1,3 SIZE=20 
[1120] DEVICE(S) TAPE 1,3 NOW ASSIGNED TO CHANNEL 'A', 
RECORD SIZE = 20 


:ASSIGN B=TAPE 2,4 SIZE=32256 
[1120] DEVICE(S) TAPE 2,4 NOW ASSIGNED TO CHANNEL 'Bt, 
RECORD SIZE = 32256 


Figure A. Sample Usage of the ASSIGN Verb 
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9.5 CLEAR=ASSIGN Verb 


The CLEAR-ASSIGN verb allows you to destroy channel assignments. 


The general form of the CLEAR-ASSIGN verb is: 


CLEAR-ASSIGN {channel} 


"Channel", if present, is any alphabetic character from A to Z. If a channel 
is not specified, all tape assignments are destroyed. If a channel is 
specified, only the assignment associated with the specified channel is 


destroyed. 


CLEAR=ASSIGN operates only on channels associated with the user's own process. 
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:CLEAR-ASSIGN A Destroys the assignment 


associated with channel A, 


Figure A, Sample Usage of the CLEAR-ASSIGN Verb 
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9.6 Control: T-DET, T-FWD, T-BCK, T-REW, T-WEOF, and T-CHK Verbs 


This chapter describes the magnetic tape unit control verbs. 


The general form of the T-DET verb is: 


T-DET {(U)} {n} 


where: 


"(U)" allows you to detach the tape from any line except the 
spooler, if you have SYS2 privleges 


nn" is the tape unit number specified with the "U" option 


T-DET detaches tape unit 1. T=DET (U) requires that a unit (1 through 4) be 
specified. 


The general form of the T-FWD verb is: 
T-FWD {channel} {n} 
where: 
"channel" is any alphabetic character from A to Z 
"n® is the number of records the tape will move forward 
This verb moves the tape "n" records forward. The maximum value for "n" is 
32,256, If "n" is not specified, the tape moves forward to the position 
immediately beyond the next end-of-file (EOF) mark. To perform multiple 
T-FWDs, use the SPACE PROC (refer to the topic MISCELLANEOUS PROCS). 
The general form of the T-BCK verb is: 
T-BCK {channel} {n} 
where: 
"channel" is any alphabetic character from A to Z 
Mm" is the number of records the tape will move backward 
This verb moves the tape back "n" records. If "n" is not specified, the tape 
moves to the position immediately before the previous EOF mark, or to load 


point. Before reading the next record, a T-FWD must be issued to position the 
tape after the EOF mark, 
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:T-DET <er> Detaches tape unit 1. 


:T-FWD B 10 <er> Moves the tape assigned to channel B 
forward 10 records. 


:T-BCK B 2 <ar> Moves the tape assigned to channel B 
back 2 records, 


Figure A, Sample Usage of the T-DET, T-FWD, and T-BCK Verbs 
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The general form of the T-REW verb is: 

T-REW {channel} 

where "channel" is any alphabetic character from A to Z 
This verb performs a "logical" rewind of the specified channel, Only the 
current drive is rewound. If there are multiple units in the channel's 
unit-list, the first tape unit in the list is set up as the "current" unit for 
the channel. Subsequent tape operations will begin with the "current" unit. 
The general form of the T-WEOF verb is: 

T-WEOF {channel} 

where "channel" is any alphabetic character from A to Z 
This verb writes an EOF mark on the tape. 
The general form of the T-CHK verb is: 

T=CHK {channel} 

where: 

"channel" is any alphabetic character from A to Z 

This verb checks a tape file for parity errors, Error checking continues 
until an EOF mark is encountered, 
The T-CHK verb attempts to reattach the tape to the maximum size of 8190 bytes 
and all records are then read under this buffer size. This allows all records 
to be completely checked for parity regardless of the current T-ATT size. At 
the end of the T-CHK, the tape buffer is reattached at its original size. To 


perform multiple T-CHKs, use the CHECK PROC (refer to the topic MISCELLANEOUS 
PROCS). 
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:T=REW B <er> Rewinds "logical" tape unit assigned to 
channel B, 


:T+WEOF B <er> Writes an EOF mark on the tape assigned 
to channel B. 


:T-CHK B <er> Checks the tape assigned to channel B 
for parity errors and specifies 
multiple reels, 


Figure B. Sample Usage of the T=REW, T-WEOF, and T-CHK Verbs 
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9.7 Magnetic Tape I/0: T-READ Verb 


The T+READ verb dumps the contents of a tape to the terminal or printer. 


The general form of the T=-READ verb is: 


T-READ {channel} {(options)} 
where: 
"channel" is any alphabetic character from A to Z 


"options" are: 


Xx Dumps in hexadecimal instead of character format 
P Dumps to the printer 
N Inhibits automatic paging of output to the terminal 


n{-m} Dumps records from "n" to "m" as specified, counting 
from the current position of the tape. If "m" is 
omitted, m=n is assumed, If the entire "n=-m" option is 
omitted, all records up to the EOF will be dumped 


This verb dumps the contents of a tape to the terminal, or optionally to the 
printer, The T=READ operation terminates when the specified number of records 
have been dumped, or when an EOF is detected, 


Sample usage of the T=READ verb is illustrated in Figure A. 
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:T-READ (4-6) <er> Bypasses the first three records, dumps 
4th, 5th and 6th on the terminal, and 
positions tape at beginning of 7th 

record, 


:T=READ (P,4=6) <er> Same as above, but dumps to the 
printer. 


:T=READ B (X) <er> Dumps the tape assigned to channel B in 
hex on the terminal until an EOF mark 
is detected, 


Figure A. Sample Usage of the T=READ Verb 
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9.8 Magnetic Tape I/O: T-DUMP and ST-DUMP Verbs 


The ENGLISH T-DUMP and ST-DUMP verbs cause selected file items to be dumped to 


the magnetic tape unit. 


T-DUMP is an ENGLISH verb which allows you to dump selected file items to the 
magnetic tape unit. The ENGLISH verb ST~DUMP works like T-DUMP, except a SORT 
is performed prior to the dump. T-DUMP and ST-DUMP work only with the default 
channel. The general form of an ENGLISH input sentence using the T=-DUMP verb 
is: 


T-DUMP {DICT} file-name {item-list} {selection-criteria} 

{HEADER "identification"} {(options)} 

where: 
"file-name" is the name of the file to dump 
“item=-listt is a list of the item-ids to dump 
“selection-criteria™ are specified output conditions 
identification"! is the tape label information 
"options" are: 
I Lists the item-ids as they are dumped 


P Prints the item=id list on the printer when used with 
the 'I' option 


T Inhibits writing the tape label 


The file-name may be preceded by the DICT modifier to dump dictionary data. 
File definition items (D/CODE = D) are not dumped. The "item-list" and 
Nselection-criteria" (described in the ENGLISH Programming Manual) cause a 
selected subset of items in the specified file to be dumped to tape. As in 
other ENGLISH statements, each item-id must be enclosed in single quotes. If 
the "item-list" and "selection-criteria" are omitted, all items are dumped. 
Note: The "item-list" may be supplied by a previous SELECT, SSELECT, GET-LIST 
or FORM-LIST verb, in which case the selection-criteria is omitted. 


The "HEADER" option allows you to generate tape label identification. The 
"identification" material must be enclosed in double quotes. Labels are 
always written at the beginning of each tape file, unless specifically 
suppressed. For further information see the Tape Labels section in this 
chapter. 
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Figure A. illustrates the general form of T-DUMP and ST-DUMP ENGLISH 
sentences. Sample usage of the T-DUMP verb is illustrated in Figure B. 


Files saved by a T-DUMP operation may be used with the ENGLISH tape 
connective. For more information, refer to the topic USING THROWAWAY 
CONNECTIVES in the ENGLISH Programming Manual. 


T=DUMP {DICT} file=name {item-list} {selection-criteria} 


specifies specifies specifies 
dictionary | | file eligible 
items 


ST-DUMP {DICT} file-name {item-list} {selection-criteria} 


{HEADER "identification"} {(options)} 

specifies I - List item-ids 

tape label P = If used with 'I', will output to printer 
identification T - Inhibit automatic tape label 


{HEADER "identification"} {(options)} 


Figure A, General Form of T=DUMP and ST=-DUMP ENGLISH Sentences 


tT-DUMP TEST > '522' <er>d Dumps to tape all items in the file 
TEST with item-ids greater than 522. 


:T=-DUMP DICT TEST <er> Dumps to tape all items in the 
dictionary of file TEST, except 
'DL/ID'. 


Figure B, Sample Usage of the T-DUMP Verb 
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9.9 Magnetic Tape I/0: T-LOAD Verb 


The T-LOAD verb allows you to load files previously saved by a T-DUMP 


operation. 


The T-LOAD verb works only with the default channel. The general form of an 
ENGLISH input sentence using the T-LOAD verb is: 


T-LOAD {DICT} file-name {item-list} {selection-criteria} {(options)} 
where: 
"filename" is the name of the file to be loaded 
"item-list" is a list of the item-ids to be loaded 
“"selection-criteria" are specified output conditions 
"options" are: 


0 Overwrites all items currently in the file that have 
item-ids corresponding to those on the tape 


P Lists item-ids on the printer as they are loaded 
5 Suppresses the item-id listing 


This verb writes to disc dictionaries or data files saved by a T=-DUMP 
operation, Data from the tape is loaded to the file "file-name", The 
file-name may be preceded by the DICT modifier to load dictionary data. The 
"item-list® and "selection-criteria" (described in the ENGLISH Programming 
Manual) cause a selected subset of items in the specified file to be loaded. 
Note: The "item-list" may be supplied by a previous SELECT, SSELECT, 
GET-LIST or FORM-LIST verb, in which case the selection-criteria is omitted. 
Item-ids will be listed at the terminal as they are loaded, unless the 'P! 
option is used to specify the printer. The tape is positioned at the EOF mark 
at the conclusion of the operation. 
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T-LOAD {DICT} file-name {item-list} {selection-criteria} {(options)} 


specifies specifies specifies ") - Overwrites items 


dictionary file eligible S - Suppresses list 
items P - Produces item 
list on printer 


Figure A. General Form of T-LOAD ENGLISH Sentence 


:T=LOAD TEST <er> Loads previously saved tape file to 
file TEST. Items will not be 
overwritten. 


s:T=LOAD DICT TEST (S,0) <er> Loads previously saved tape file to 
dictionary of file TEST. Listing of 
item-ids is suppressed. Items will be 
overwritten. 


Figure B, Sample Usage of the T=LOAD Verb 
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9.10 Magnetic Tape I/0: MT-LOAD and MT-VERIFY Verbs 


The MT-LOAD verb loads assembly code from magnetic tape. The MT-VERIFY verb 
verifies the assembly code. The T-DUMP verb must be used to write the 


assembly language routines ("modes") to tape prior to using MT-LOAD or 
MT-VERIFY. 


The general form of the MT-LOAD verb is: 
MT=LOAD {item=list} 
where "item-list" specifies the item=-ids to load. 
This verb loads the item-ids specified in the "item-list" from tape to the ABS 
area. Items in the "item-list" are separated by blanks. The “item-list" may 
be supplied by a previous SELECT, SSELECT, GET-LIST or FORM-LIST verb. If the 
Nitem=-list™ is omitted, all item-ids are loaded. 
The general form of the MT-VERIFY verb is: 
MT-VERIFY {item-list} {(options)} 
where: 
"item-list" specifies the items-ids to verify 
"options" are: 
A Causes a columnar listing of all mismatched bytes. 
Each byte in the source file which mismatches is 
listed, followed by the value in the ABS frame. If 


this option is not specified, only the first 
mismatched byte in each frame is printed 


E Inhibits printing of verification message lines. When 
this option is specified, only error messages are 
printed 

P Sends output to the printer 


This verb checks the modes stored on tape against the ABS area. As each mode 
is verified, or if a mismatch occurs, a message is displayed. The modes which 
are to be verified are specified in the optional "item-list". 


The MT-LOAD and MT-VERIFY routines do not position the tape. This must be 
done by the user. The routines work with items placed on the tape by the 
ENGLISH verb T=-DUMP. Modes are retrieved from the tape until either an EOF is 
detected, or the “item-list" is exhausted. If processing has stopped because 
the "“item-list" is exhausted, the tape probably will not be positioned at 
end-of-file, 
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Sample usage of the MT-LOAD and MT-VERIFY verbs is illustrated in Figure A, 


:MT=LOAD <er> 


:MT-LOAD TCL=-I <er> 


:MT=LOAD TCL=-I EDIT=-I DB6 <er> 


:MT-VERIFY <cer> 


:MT=VERIFY (E) <er> 


sMT-VERIFY SORT <cr> 


Loads all modes from the tape into 
executable frames. 


Loads only the TCL-I mode from tape. 


Loads the modes TCL=-I, EDIT=I and DB6 
from tape. 


Verifies that the modes stored in 
virtual memory are identical to the 
modes stored on the tape. 


Verifies that the modes stored in 
virtual memory are identical to the 
modes stored on the tape, and 
suppresses verification message lines, 


Verifies only the mode SORT. 


Figure A. Sample Usage of MT=-LOAD and MT-VERIFY Verbs 
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9.11 Tape Labels 


This section includes information on tape label size, placement and use. 


Many system processors generate tape labels when writing to tape. These 
processors also check for a label when reading a tape. Processors that write 
and/or check for tape labels are DATA/BASIC, ENGLISH T-LOAD and T-DUMP, 
file-save, and file-restore. 


A tape label is 50 characters long and is written at the beginning of the 
reel. When you generate a tape, you may specify identification information 
which will be included in the label. This information may be up to 16 
characters long. If identification information is specified, the format of 
the label is: 


(SM) L identification (VM) time date (AM) reel# (AM) 
record size (AM) (SM) blanks (if necessary) 


If the label is not 50 characters long, it will be padded at the end with 
blanks. 


Label creation may be suppressed by using the 'T' option with any verb that 
causes tape output (T=DUMP, SAVE, RUN, etc.). 
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LQUARTERLY A/R]03:25:57 12 FEB 1983°1°2048*_....(PAD with blanks ‘to 
; 50 characters) 


LQUARTERLY A/RJ]03:25:57 12 FEB 1983*2*2048*_....(PAD with blanks to 
50 characters) 


LQUARTERLY A/RJ]03:25:57 12 FEB 1983°3*2048*_....(PAD with blanks to 
50 characters) 


Time and date 
Optional identification information 


Figure A. Example of Labels for a Multireel Tape Operation 
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9.12 Reading Tape Labels: T-RDLBL Verb 


Tape labels are generated by most tape writing operations and may be read with 


the T-RDLBL verb. 


The general form of the T-RDLBL verb is: 
T-RDLBL {channel} n 
where: 
"channel" is any alphabetic character from A to 2 
tn" is the reel number 


This verb reads, displays and stores the label from tape reel number "n" on 
the specified channel. Channel specification is optional. T=-RDLBL 
automatically changes the record size if it is different from the size 
previously attached. 


T-RDLBL must be used to initialize the internal label storage area when you 
are working with file-save or account-save tapes, or when beginning tape 
operations on a reel other than Reel #1. 


You only need to use T-RDLBL once when working on a tape set, as the label 
data is stored during a logon session. An example is a SEL+RESTORE which 
begins with Reel #2 of a three reel file-save. When Reel #2 reaches 
end-of=tape (EOT), the system must be able to prompt for reel three. It is 
able to do so only if, prior to the SEL-RESTORE, Reel #2 was mounted at load 
point, and the verb "T-RDLBL 2" was used to initialize the label buffer. 


NOTE 
T-RDLBL must be used when performing an ACCOUNT-RESTORE, 


SEL-RESTORE or any other operation involving a save tape, 
even if it is a single reel operation. 
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:T=RDLBL 1 <er> 
LABEL = DOC, ACCTJ]08:01:04 11 APR 1982 
TAPE SIZE CHANGED TO 08190 


:T+RDLBL B 1 


:T-RDLBL 3 


Tape size changed to size 
specified in tape label. 


Reads, displays and stores the 
label from the first reel 
assigned to channel B,. 


Reads, displays and stores the 
label from the third reel, 


Figure A, Sample Usage of the T-RDLBL Verb 
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9.13 Multiple Reel Tape Operations 


This section describes multiple reel tape operations. 


When a tape reel reaches the EOT marker, the tape system rewinds and sets the 
current drive offline. Tape operations continue with the next drive specified 
in the unit list. If this drive is offline, the prompt: 


MOUNT REEL # n ON DRIVE m 
TYPE 'C* TO CONTINUE 


is displayed. When the next reel has been mounted, enter the character "Cm to 
continue the operation. The system will ignore all entries other than "Cc", 


NOTE 
The prompt cannot be suppressed, and input to this prompt 
cannot be "stacked" by a PROC. 


Figure A. lists the messages that may appear while reading labeled tapes. 


These messages will appear if a problem is encountered when reading the first 
record on any "next reel" operation. 
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REEL OUT OF SEQUENCE! 
PREVIOUS LABEL: [= =50 bytes= -| 
RECORD FOUND: |= =-50 bytes- -! 


BYPASS LABEL CHECK? (Y/N) 
TYPE Y (YES), N (NO), Q (QUIT) 


WRONG LABEL! 
PREVIOUS LABEL: |= -50 bytes- -| 
RECORD FOUND: |= =50 bytes- -| 


This message is displayed when the reel 
number on the labeled tape does not 
match the requested reel number, or if 
the first tape mounted is not reel 
number one. 


This message is displayed if the tape 
label on a subsequent reel does not 
match the tape label on the first reel. 


BYPASS LABEL CHECK? (Y/N) 
TYPE Y (YES), N (NO), Q (QUIT) 


UNLABELED TAPE! 

PREVIOUS LABEL: |= -50 bytes- -!} 
RECORD FOUND: |= -50 bytes- -| 
BYPASS LABEL CHECK? (Y/N) 

TYPE Y (YES), N (NO), Q (QUIT) 


This message is displayed if an 
unlabeled tape is mounted when the 
first reel was labeled. 


Figure A, Multiple Reel Tape Operation Messages 


If you enter Yes (Y) to the 'BYPASS LABEL CHECK! ‘question, the following 
prompt is displayed: 

TYPE A (ACCEPT), S (SKIP), OR Q (QUIT) 
Enter 'A' to accept the "label" as a data record and resume read operations. 


Enter 'S' to skip the "label" and resume read operations with the next record. 
Enter 'Q* to exit to TCL, 
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9.14 T-COPY Verb 


The T-COPY verb allows you to perform a tape-to-tape copy. 


The general form of the T-COPY verb is: 
T-COPY channel1 channel2 {n} {(F)} 
where: 
Nchannel1" is the source channel name 
"ochannel2" is the destination channel name 
tnt as the number of files to copy 
"(F)™ causes consecutive save tape reels to be labeled 
This verb allows you to perform a tape~to-tape copy. "Channel1" and 
Tohannel2" must be specified, and the channels must be assigned before using 
the T-COPY verb. If "n" is not specified, the system will copy all files up to 
two consecutive EOF's. If the tape does not contain two consecutive EOF'S, an 
unrecoverable parity error may appear in the first record following the actual 
data. You may terminate the copy at this point. 
The tape copy is a logical copy, as there is no physical reel to reel 
correspondence between the original tape and the copy. The number of reels in 
the copy does not necessarily match the number of reels in the original. 
If the original tape is labeled, the copy will also be labeled. Note that the 
time and date in the label of the copy will be the time and date the copy was 
made, not the time and date the original was made, If the original tape is 
not labeled, the copy will not be labeled. 
WARNING 
Binary save tapes can not be copied because the 


format is different than the format of a logical 
save. 
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:T=COPY AB Copies all files from Channel A to 
Channel B. 


:T-COPY A B 3 Copies 3 files from Channel A to 
Channel B. 


:T-COPY AB (F) Copies a FILESAVE or SYSGEN tape from 
Channel A to Channel B, 


Figure A, Sample Usage of the T=COPY Verb 
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10.1 Arithmetic Verbs 


This chapter discusses a set of special utility verbs executable at the TCL 


level. This initial topic describes the arithmetic verbs. 


Figure A presents general forms of the arithmetic verbs. To terminate the verb 
format, press the RETURN key; the system will then return the arithmetic 
result. 


Figure B shows sample usage of these verbs. Note that in the system output for 
the DIVD and DIVX verbs, a space separates the quotient from the remainder. 


Also note that negative decimal numbers are specified by appending a minus sign 
immediately prior to the first digit of the number. Hexadecimal numbers are 
considered negative when in the range from X’FFFFFFFFFFFF’ (-1) to X 
“800000000001’ (-140, 737,488, 355,327). 
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ADDD Add decimal "n" to deetmal "m't 
ADDX Add hex "n" to hex "m" 
SUBD n 1 Subtract decimal "m" from decimal "n" 


SUBX Subtract hee "m" from hex 'n" 


MULD Multtply deetmal "n" by decimal "m" 


MULX Multiply hex "n" by hex "m" 
Divtde deetmal "n" by deetmal "m"' 
Divide hex "n" by hex "m" 
Convert decimal "n" to hex 


Convert hex 'n" to decimal 


Figure A. General Forms of Arithmetic Verbs 


800000000004 


79 ae 
t Remainder 


Quottent 


Figure Be Sample Usage of Arithmetic Verbs 
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10.2 Setting Device Characteristics: TERM Verb 


Terminal and/or printer characteristics may be displayed or set for the port 


you are logged on via the TERM verb. 


TERM 


This statement sets the terminal/printer characteristics for the port you are 
currently logged on. The general form of the TERM verb is: 


TERM {a,b,c,d,e,f,g,h,i,j »k,1} {(m)} 
where: 


a - is terminal line length (i-e., number of characters per line). The ‘a’ 
parameter must be in the range 10<a<140. 

b - is the number of ape lines per page on the terminal. 

c + is the number of blank lines per page on the terminal (sum of “b’ and 
“oe” equals page length). 

d- is the number of delay or idle characters following each carriage 
return or line feed. This is used for terminals that require a pause 
after a carriage return or line feed. This parameter should be set 
between 20 and 127 for MATRIX terminals running at 1200 baud. 

e- is the number of delay characters following each top-of-form and 
form-feed control. If e’ is two or greater, a form feed character is 
also output to the terminal before each page. If ’e’ is zero, no, form 
feed character is output to either the terminal or printer. tf ’e’ is 
one, a form-feed is output to the printer but not to the terminal. 

f - is the backspace character. This parameter should be eight for all 
terminals. This defines the character which, upon receipt by the 
system, is treated as a backspace.e When this character is entered, the 
system will delete the previous data character entered and echo the ’f’ 
parameter followed by a space, followed by the “f° parameter again. 
When this is the first character entered on a line, it is ignored. 

g- ne are aaa line length. This parameter must be in the range 

<g< . 

h - is the printer page length. 

i- is the terminal type. If using MDATA/BASIC cursor control and _ the 
MATRIX terminal, “i” = 2. If using any other terminal, the ‘i’ 

parameter should be zero. 

- is the baud rate. The values BuEpe ares are 19200, 9600, 7200, 4800, 

3600, 2400, 2000, 1800, 1200, 600, 300, 150, 134, 110, 75 and 50. 

is a PCI setting which defines character fength, pectey and number of 

stop bits. This pores may be a decimal number between 0 and 255. 

- specifies the number of linefeeds to be appended to a formfeed (e-g., 

alioge a WORDMATE header to be printed on a letter-quality printer). 

- is a numeric option to specify the port number. 


BoP wu 
1 


If a PRISM is to run at or below 110 baud, two stop bits should be specified 
(*k’ parameter). The byte is defined in the following hexadecimal format: 


Bits (L to R) Meaning 
Oo-1 00 invalid 
Ol 1 stop bit 
10 1.5 stop bits 


1 2 stop bits 

odd parity 

even parity 

disable parity 

enable parity 

5 bit character length 
6 bit character length 
7 bit character length 
8 bit character length 
ways 10 


ftir ntin nnn oe 


1 
0 
1 
0 
1 
4-5 00 
01 
10 
ll 
al 
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A set of typical values are as follows: 


Hex Decimal Meaning 

4A 74 7 bit, no parity (5750) 

4E 78 8 bit, no parity 

5A 90 7 bit, odd parity (PRISM IT) 
5E 94 8 bit, odd parity 

7A 122 7 bit, even parity 

7E 126 8 bit, even parity 


Individual parameters may be null (ise., as specified by two adjacent commas in 
the TERM verb). If so, the previously defined parameter remains in force. If 
4 parameter is specified that is out of range, an error message is output and 
that parameter retains its previously defined value. A TERM command without a 
parameter list displays the current characteristics. 


If a numeric option is entered (’m’ parameter), the display/changes apply to 
the given port. However, the verb only allows you to change another port’s 
baud rate and PCI setting. Attempted changes to any other TERM parameters on 
another port are rejected. Because the DMP controls terminal I/0 to Port Zero 
independently of the operating system, you cannot change Port Zero’s baud rate 
or PCI setting. Instead, use Option 7 of the System Control Menu to change 
Port Zero’s baud rate. 


If a coldstart, ABS load or “AF” restore is performed, the system reverts back 
to the default terminal characteristics specified by the hardware. 


~t——__ Alter characteristics. 


Display charactertstics. 
TERMINAL PRINTER 


PAGE WIDTH: 79 132 

PAGE DEPTH: 24 60 

LINE SKIP ¢ 0 ~t-——— Number of linefeeds appended to form- 
LF DELAY : feed. 

FF DELAY 3: 

BACKSPACE ; 

TERMINAL 3 

BAUD RATE : 

PCI H 


—t—_————- Alter characteristics. 


Display charactertstics. 
TERMINAL PRINTER 
PAGE WIDTH: 85 
PAGE DEPTH: 36 
LINE SKIP : 2 —<t—-—— Number of linefeede appended to form- 
LF DELAY ; feed. 
FF DELAY 
BACKSPACE : 
TERMINAL 
BAUD RATE : 
PCL : 


Figure A. Sample Use of TERM Verb 
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10.3 Setting Device Characteristics: SET-TERM Verb 


Terminal and/or printer default characteristics may be set for all ports via 


the SET-TERM verb. 


The general format of the SET-TERM verb is: 
SET-TERM {a,b,c,d,e,f,g,h,i} 
where: 


a - is terminal line length (i-e., number of characters per line). The ‘a’ 
parameter must be in the range 10<a<140. 

b - is the number of print lines per page on the terminal. 

c - is the number of blank lines per page on the terminal (sum of “b’ and 
“ce” equals page length). 

d- is the number of delay or idle characters following each carriage 
return or line feed. This is used for terminals that require a pause 
after a carriage return or line feed. This parameter should be set 
between 20 and 127 for MATRIX terminals running at 1200 baud. 

e- is the number of delay characters following each top-of-form and 
form-feed control. If ‘’e’ is two or greater, a form feed character is 
also output to the terminal before each page. If ’e’ is zero, no form 
feed character is output to either the terminal or printer. If ’e’ is 
one, a form-feed is output to the printer but not to the terminal. 

f - is the backspace character. This parameter should be eight for all 
terminals. This defines the character which, upon receipt by the 
system, is treated as a backspace. When this character is entered, the 
system deletes the previous data character entered and echoes the ”f’ 
parameter followed by a space, followed by the ‘f% parameter again. 
When this is the first character entered on a line, it is ignored. 

g - is the printer line length. This parameter must be in the range 
10<g<140. 

h - is the printer page length. 

i- is the terminal type. If using DATA/BASIC cursor control and the 
MATRIX terminal, ‘i’ = 2. If using any other terminal, the ‘i’ 
parameter should be zero. 


The SET-TERM verb sets the default printer and terminal characteristics except 
the baud rate and PCI setting for subsequent logons on all terminals. This 
verb is present only on the SYSPROG account. 

If no parameter list is entered, the characteristics are displayed as for the 
TERM verb. The baud rate and the PCI setting for the port executing the verb 
will then be printed. 


Figure A summarizes the general form of the SET-TERM verb. 
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PAGE WIDTH: 
PAGE DEPTH: 
LINE SKIP 
LF DELAY 
FF DELAY 
BACKS PACE 
TERMINAL 
BAUD RATE : 
PCI 


PAGE WIDTH: 
PAGE DEPTH: 
LINE SKIP : 
LF DELAY : 
FF DELAY 3: 
BACKS PACE 
TERMINAL 
BAUD RATE : 
PCI 


33-1L10Y 


—@- Alter characteristics. 


<+——_—____——-______—_—_—- Display characteristics. 
TERMINAL PRINTER 
79 80 
24 60 
0) 


te ———————. Alter characteristics. 


<< _____——_—— Display characteristics. 


TERMINAL PRINTER 
79 85 
56 
0 


Figure A. Sample Use of TERM Verb 
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10.4 Setting Device Characteristics: TERMINAL PROC 


The TERMINAL PROC allows you to build a parameter and options list for the TERM 


verb by printing a menu, soliciting values for each parameter, and editing the 
values entered. 


To generate such a list, type in the following: 
+ TERMINAL 


If a menu for another port is displayed, only changes made to the baud rate and 
PCI characteristics will be accepted. In addition, the PCI transmission 
characteristics cannot be changed without defining the baud rate first. While 
entering data, you may enter "HELP" to get assistance or "EX" to exit. 


The following is a list of messages that may be generated when errors are 
detected by the verb TERM, SET-TERM or the TERMINAL PROC. 


(1010) The parameters being changed are not compatible 
with the port option. 


(1011) Baud rate and PCI transmission characteristics 
cannot be modified with the SET-TERM verb. Use 
"TERM" instead. 


(1012) The PCL transmission characteristics cannot be 
changed without also defining the baud rate. 


(1013) Port zero’s baud rate or PCL transmission 


characteristics cannot be modified with the TERM 
verb. Use the DMP instead. 
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WHICH PORT NUMBER (RETURN IF OWN PORT)? 
TeERMENAL SETTLING CONTROL MENU 


Ll. TEKMINAL PAGE WIDTH : 
2. TERMINAL PAGE DEPTH 
3. LINE SKIP 

4, LINE FEED DELAY 

>. FORM FEED DELAY 

6. BACKSPACE CHARACTER ; 
7. PRINTER PAGE WIDTH 
3. PRINTER PAGE DEPTH 
9. TERMINAL TYPE 

LU. BAUD RATE 

Ll. PUL SKITING 

12. PRINTER LINE SKIP 


[IS THIS CORRECT (FI/LINE NUMBER/EX)? 


TERMINAL PRINTER 
PaGE WIDTH: 7y 85 
PAGE DEPTH: 24 56 
LINE SKIP : 1 2 
LF DELAY ; 
FF DELAY: 
BACKSPACE : 
TERMINAL 
BAUD KATE : 
PCL 


Figure A. Sample Use of TERMINAL PROC 
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10.5 Blocking Printing: BLOCK-PRINT and BLOCK~TERM Verbs 


The BLOCK-PRINT or BLOCK-TERM verb prints characters in a 9=by=-n block-form on 


the printer or your terminal, respectively. 


The general form of the BLOCK-PRINT verb is: 
BLOCK=PRINT character=-string 


This verb causes the specified character-string to be block-printed on the 
printer. Multiple character-strings separated by blanks are output on separate 
lines. Any character-string containing single quotes (*) must be enclosed in 
double quotes ("), and vice versa. The surrounding quotes are not printed. A 
character-string not containing quotes as part of the string need not be 
surrounded by quotes, unless embedded blanks are to be preserved. 


The general form of the BLOCK-TERM verb is: 
BLOCK-TERM character-string 


This verb is identical to the BLOCK-PRINT verb, except that the text string is 
output in block=-print form to your terminal. 


Character-strings must be such that the total number of characters does not 
exceed the current line length set by the most recent TERM verb. 


If a BLOCK=PRINT or BLOCK-TERM verb is illegally formed, any of the error 
messages 520 through 525 may be displayed (refer to the list of error messages 
in the Appendix). 


BLOCK=PRINT and BLOCK-TERM verbs use the BLOCK-CONVERT file to create the 
characters. This existing file contains conversion specifications for all 
printable ASCII characters (no lower case alphas, however). With this file, 
characters will be printed in 9-by-12 to 9-by-20 blocks. 


If you wish to change the way any character is printed, you must change the 
corresponding item in the BLOCK-CONVERT file. The item-id of the item is the 
character to be converted. Each item in the file must consist of exactly 10 
attributes. The first must specify in decimal the number of horizontal bytes 
in the blocked character to be output (i-e., "n" of the 9-by-n block mentioned 
above). The second and Subsequent attributes provide the conversion 
specification. These attributes contain one or more values; each value is 
separated from the preceding by a value mark (<c>], X’FD’). The first 
character of the first value in each attribute must be "C" or "B'S these 
signal that the output matrix line of the blocked character begins with a 
character or a blank, respectively. Immediately following must be the number 
of characters or blanks (in decimal). The presence of a value mark indicates a 
switch from character to blank status (or vice versa) and must be followed by 
the number of bytes to be output. For example, an "X" might be specified as 
shown in Figure B. 


208 : 83-1109 


LO SPECIAL SYSTEM ULLLIELES 


K~TERM AB12- <er> 


BBBBBBBBBBB Llll 2222222222 
AAAAAA BBBBBBBBBBBB 111111 222222222222 
AAAAAAAA BBBB BBBB 1111111 2222 2222 
AAAA  AAAA BBBBBBBBBBBB liill1l 2222 
AAAA AAAA BBBBBBBBBBB 1111 22222222222 
AAAAAAAAAAAA BBBB BBBB llll 222222222222 
AAAAAAAAAAAA BBBB BBBB 1111 2222 
AAAA AAAA BBBBBBBBBBBB LLLLLIIILL1 222222222222 
AAAA AAAA BBBBBBBBBBB TL1L1I111111 222222222222 


:BLOCK=PRINT AB12 <cr> 
Produces identical output as above, but on printer. 
:BLOCK=PRINT "X‘Y’Z"  <er>. 


Produces bloek=print of "X'Y'Z". 


Figure Ae Sample Usage of BLOCK~PRINT and BLOCK-TERM Verbs 


Item “X’ in file BLOCK-CONVERT 


O01 12 ~q——__-_——. sloeked character is 12 bytes wide. 

002 C4}4]4 «-——_—- Output 4 characters, 4 blanks, 4 charactere. 

003 B1]4]2)4]1—¢— Output 1 blank, 4 characters, 2 blanks, 4 characters, 1 
blank. 

004 B2]8) 2 ¢—————- Output 

005 B3]6]3—<———— Output 


blanks, 
blanks, 


characters, 2 blanks. 
characters, 5 blanks. 


007 B3]6)]3———— Output 
008 B2]8)]2 ~———— Output 
009 B1]4)2)4] lmqe— Output 

blank. 
010 C4)4)4—¢-————- Output 4 characters, 4 blanks, 4 characters. 


blanks, characters, 3 blanke. 
blanks, characters, 2 blanks. 
blank, 4 characters, 2 blanks, 4 characters, 1 


2 8 
3 6 
006 B4]4)4~—q————- Output 4 blanks, 4 characters, 4 blanke. 
3 6 
2 & 
1 


Figure B. Sample Item in BLOCK-CONVERT File 
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10.6 Dumping to Terminal: I-DUMP and S-DUMP Verbs 


I-DUMP and S-DUMP are ENGLISH verbs that allow you to selectively 


dictionaries and data files to the terminal. 


I-DUMP 
The I-DUMP verb (Figure A) has the following general form: 

I=DUMP {DICT} file-name {item-list*} {selection-criteria} { (options) } 
The “item-list" and "selection-criteria" (described in the ENGLISH Programming 
Manual) cause a selected subset of items in the specified file to be dumped to 
the terminal. If omitted, all items are dumped. The DICT modifier causes 
dictionary data to be dumped. File definition items (D/CODE=D) are not dumped. 
S=-DUMP performs a sorted I-DUMP. 
Valid options for these two verbs are: 

N -— Inhibit automatic paging of output to terminal 


P - Direct output to printer 


* The item-list can be supplied by a previous SELECT, SSELECT, GET-LIST or 
FORM-LIST command, in which case the selection~criteria is omitted. 
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I-DUMP {DICT} file-name {item-list*} {selection-criteria} { (options) } 


specifies specifies Limits N Inhibits paging 
file eligtble eltgtble P Outputs to printer 


ttems items 


S-DUMP {DICT} file-name {item=-list*} {selection-criteria} {sort-criteria} 
{ (options) } 


Figure A. General Form of I-DUMP and S-=DUMP Verbs 


:I-DUMP TEST ’14’ ‘15’ °16’ <cr> 


14°THIS“IS*ITEM™147111}]222]3337AAA] BBB] CCC]DDD71 2345678907 


L5“THIS“ LS“ ITEM 1 5“ABCDEFGHIJK~.].J]eJeJs] 
16~THIS“IS~ITEM~1671234]5678)]9012) 3456] 7890~XXXXXX~ 
3 ITEMS DUMPED. 


Figure B. Example of I-DUMP Verb 
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10.7 DUMP Verb 


The DUMP verb allows you to examine the contents of virtual memory frames in 


character or hexadecimal format. Use of this verb requires a system privilege 
level two. 


The general torm of tne DUMP verb is: 

DUMP fidl{-fid2} {(options)} 
where "“fidl" is the beginning FID and "“fid2" is the ending FID. If “fidl" is 
specified alone, only that frame is dumped; "fidl" and "fid2" may be specified 
as hexadecimal by preceding them with a period. If "“fid2" is hexadecimal, it 
should not be preceded by the hyphen (-). 


Valid options are listed below. Multiple options are separated by commas. 


G wvunps group data - all linked frames beginning with "“fidl" are 
displayed; “fid2", if present, is ignored 


L Like “G*, but dumps linked fields of frame only (no data dump) 

N Suppresses pagination of terminal display 

bP Dumps to the printer instead of the terminal 

U When used with the “G* or “L” option, causes dump to follow backward 
links instead of default forward links; if “U” is used without °G* or 
“L° option, the “G” option is assumed. 


xX Displays data in hexadecimal as well as character format 


Link information is displayed in decimal and hexadecimal. A "+" next toa 
frame indicates a frame found by tracking forward links. A "“-" indicates a 
link found by tracing backward links (“U" option). Figure B shows examples of 


the DUMP verb. 


DumMP tidl{-fidz} {(options)} 


Dumps group data 
Dumps link fields only 


Suppresses paging of terminal display 


Dumps to printer 
Traces backward links (with 'G' or 'L' opttone) 
Dumps in hexadecimal format also 


Figure A. General Form of DUMP Verb 
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# of # of 
Next Prevtous 
Contiguous Forward Backward Contiguous Hex 
FID: Frame Link Link Frame Equivalents 


Me ee 


5400 : 0 10532 0 0 ( 1518: 0 2924 


see) Se eee 6001 SCHARGE-TO*P~60327001 7C-READ™P 72794 
““CUN700 1A ZERO-DISC-ERRS*P~20CF*O01B¥A 117A*1 177777 
“*LLO“L“OOILCCT*PQ* (DICT PROCLIB CT)*0018T-WEOF*PZ 
~60337B0237002F BLOCK~CONVERT~Q™BLOCK-CONVERT****** 
“L7LO7*1“OO02ALISTDICTS*PQ*(DICT PROCLIB LISTDICTS)~ 
0016SA VE-LIST~PL~20647001 3S P=-STOP~P71 0A 6*001D¥A 37A, 
SOS SO "TLO*L LO" 1-001 FILMCO “SYSTEM TIM APA AL A106 
“O01 4MT-VERIF Y“PV~D 17002 7PF~Q*SYSTEM*PO INTER-F LLE* 
“***"R~1070092BRANCH™ FRAME 400] FRM: 400 001 7FFO 
0190 ORG 1 OO1L **7AOOMAR777ATH*ATHA“AAH™ BST LABX 
OOL 19FD™ OR 


Dump frames X'2HA' through X'2kC’; dump 
links only; trace backward links. 


0 0 2EA : 2EB 


: 2EC 
2EA : 2EB 


2ED 
2EC 
2EB 


Dump frane 5400 in hex and character format. 
5400 : 0O 10532 0 0 ( 1518: O 2924 0 0 ) 


00000000 29240000 00000000 30303135 Se eee)Seeeee AILS: 
43484152 47452D54 4FFESOFE 36303332 : CHARGE-TO7P6032: 


2AFE2AFE 2AFE2AFE 2AFE2042 534C204C aR Re Bot bs 
414258FC 30303120 31394644 FE204F52 _ tABX 001 19FD™ OR: 


Figure B. Examples of DUMP Verb 
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10.8 FID Information: ITEM and GROUP Verbs 


ITEM and GROUP verbs provide information about the item and group structure of 


SEQUEL files. Output can be displayed at the terminal or optionally directed 
to the printer. 


ITEM 
The ITEM verb has the following general form: 
ITEM file-name item-id { (options) } 


This verb displays the base FID of the group into which the specified item-id 
hashes. If the item is not on file, the message "ITEM NOT FOUND" is displayed. 
In addition, every item-id in that group is listed in the order in which it 
occurs in the group along with a character count of the item (in hex). At the 
end of the list the following message is displayed: 


n ITEMS m BYTES p/q FRAMES 
where: 
is the number of items in the group 
is the total number of bytes used in the group 


is the number of full frames in the group 
is the number of bytes used in the last frame of the group 


atu BS 


Valid options for this verb are: 


N - Defeat automatic paging of terminal output 
P — Direct output to printer 
S - Suppress item list 

GROUP 


The GROUP verb has this general form: 

GROUP file-name { (options) } 
This verb is similar to the ITEM verb, but GROUP displays the base of FID of 
every group in the specified file. In addition, every item-id in each group is 


listed along with a character count of the item (in hex). The end of list 
message for each group and valid options are the same as for the ITEM verb. 
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ITEM file-name item-id { (options) } 


N = Defeat automatte paging 
P - Output to printer 


S - Suppress ttem-ltst 


GROUP file=name { (options) } 


Figure A. General Form of ITEM and GROUP Verbs 


1895 «——_—_—_—__-—— Beginning FID of group tn whtch item 
0007 10 '14' restdes. Order of items ts '10', 
0007 11 '11', and '14'; each te seven bytes. 
0007 14 

3 ITEMS 21 BYTES 0/21 FRAMES 


1895 | 
3 LTEMS 21 BYTES 0/21 FRAMES 


: r> 

1895 <q————_—_______— Beginning FID of sirst group. 
0007 10 

0007 11 

0007 14 

3 ITEMS 21 BYTES 0/21 FRAMES 

1896 —q¢———_—_______________ Beginning FID of second group. 
0009 12 

000A 33 

0008 28 

0010 92 

4 ITEMS 43 BYTES 0/43 FRAMES 

189 7 Beginning FID of third group. 
OOLF 88 

1 ITEMS 31 BYTES 0/31 FRAMES 


Figure B. Sample Usage of ITEM and GROUP Verbs 
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10.9 Hashing Information: ISTAT and HASH-TEST Verbs 


ISTAT and HASH-TEST are ENGLISH verbs that produce file hashing statistics and 


an optional histogram; ISTAT for specified file items and HASH-TEST on the 
basis of a user-specified test modulo. 


ISTAT 


An ENGLISH sentence using the ISTAT verb is illustrated in Figure A. The ISTAT 
verb provides file hashing statistics and, if desired, an optional histogram 
for selected items in the selected file, shown by examples in Figure B. For 
further information regarding item hashing, refer to title ITEM STORAGE AND THE 
HASHING ALGORITHM in Chapter 2. 


HASH-TEST 
HASH~TEST produces the same output as ISTAT, but uses a user-specified test 
modulo. The general form of this verb is shown in Figure A. Figure C 
illustrates a HASH-TEST dialog and printout. 
Options for these two verbs are: 

H = Prints histogram 


N - Defeats automatic paging of output to terminal 
P - Directs output to printer 


ISTAT {DICT} file-name {item-list*} {selection-criteria} { (options) } 


specifies speciftes Limtts dH - Print htstogram 
file eligtble eligtble N - Suppress paging 
items items P - Output to printer 


HASH-TEST {DICT} file-name ({item-list*} {selection-criteria} { (options) } 


The ttem-list can be eupplted by a prevtous SELECT, SSELECT, GHT-LIST or 
FORM~LIST command, in which ease the selectton-criterta is omitted. 


Figure A. General Form of ISTAT and HASH=-TEST Verbs 
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FILE= ACCOUNT MODULO= 3 SEPAR= 1 14:30:14 12 FEB 1983 
BYTES ILTMS 

05379 023 *>>>>>>>>>>>>>>>>>>>>>>> 

05391 022 *>>>>>>>>>>>>>>>>>>>>>> 

05813 023 *#>>>>>>>>>>>>>>>>>>>>5>> 


ITEM COUNT = 68, BYTE COUNT = 16583, AVG. BYTES/ITEM = 243.8 
AVG. ITEMS/GROUP = 22.6, STD DEV = +5, AVG. BYTES/GROUP = 5527.6 


FILE= ACCOUNT MODULO= 3 SEPAR= 1 14:31:15 12 FEB 1983 
BYTES ITMS 

03093 012*>>>>>>>>>>>> 

02751 O11*>>>>>>>>>>> 

03001 O11%*>>>>>>>>>>> 


ITEM COUNT = 34, BYTE COUNT = 8845, AVG. BYTES/ITEM = 260.1 
AVG. ITEMS/GROUP = 11.3, STD DEV = +5, AVG. BYTES/GROUP = 2948.3 


Figure B. Sample Usage of ISTAT Verb 


TEST MODULO: 7 <cr> 

FILE= ACCOUNT MODULO=7 SEPAR= 1 14:35:22 12 FEB 1983 
BYTES ITMS 

02413 O10*>>>>>>>>>> 

02710 OL1*>>>>>>>>>>> 

02121 009*>>>>>>>>> 

02598 OL1*>>>>>>>>>>> 

01619 007%>>>>>>> 

02462 O1L0*%>>>>>>>>>> 

02660 010%>>>>>>>>5> 


ITEM COUNT = 68 BYTE COUNT = 16583, AVG. BYTES/ITEM = 243.8 
AVG. ITEMS/GROUP = 9.7, STD DEV = 1.3, AVG. BYTES/GROUP = 2369 


Figure C. Sample Usage of HASH-TEST Verb 
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10.10 Information: MSG, WHO, and WHAT Verbs 


The MSG, WHO, and WHAT verbs provide miscellaneous system information and 


capabilities. 


MESSA r_ MSG 


All system users may communicate with other users on the system. To transmit 
a message to another user, type the verb MESSAGE (or MSG) followed by the 
user's account name or '!' followed by a destination port#, then the text of 
the message. The general form is: 


MESSAGE account-name text-string 
2eO0RS= 
MESSAGE In text-string 


where 'n" is the destination port#., For example: 


The maximum message is 108 characters long. Anyone currently active on the 
account referenced will receive the message, in the form: 


time date FROM sender: 
message 


The above message might be received as: 


12:41:37 22 FEB 1984 FROM USER-1: 
HELLO THERE 


If the specified user is not presently logged on, the system responds with 
"USER NOT LOGGED ON", If your account has system privilege level two, you may 
broadcast to all users by substituting an asterisk (*) for the account name. 
For example: 


If you are entering data at a terminal and receive a message, part of the data 
in the input buffer may be destroyed. To display what is remaining, type in 
“ook, 


HO 


The WHO verb returns the line number and account-name to which you are logged 
on. The general form is: 


WHO {n} 


where "n" specifies a line number. If specified, line "n" and the name of the 
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account logged on to line "n" are displayed. The account name is obtained by 
looking up the PCB FID in the ACC file and returning Attribute 1. If the 
account file item is not found, "UNKNOWN" is returned as the account name. 


WHAT 


The WHAT verb causes the current system configuration parameters to be 
displayed. The general form is: 


WHAT 


Figure A illustrates the use of the MSG, WHO and WHAT verbs. 


| You are on Line 22 and Logged 
22 SYSPKUG on to SYSPROG aceount. 


User on Line 3 te logged on 
to account GARY. 


2048K OF HEMORY 

1215 ABS FRAMES 

i7 ACTIVE LINES 

lo IS THE LINE TO WHICH THE SPUOLER IS ASSIGNED 

1216 Is THE FRAME [Db OF THE PCB FOR LINE ZERO 

79UV IS THE FRAME [LD OF THE BASH Gr THE SYSTEM DICTIONARY 
998143 Is Toh MAXIMUM FRAME LD FOR THIS SYSTEM 


DISC DRIVE CONFIGURATION: 
DEVICE ADDRESSES 
DU 
bl 
be 
b3 


Figure A, Fxamples of the MSG, WHO and WHAT Verbs 
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10.11 Information: TIME, SET-TIME, SET-DATE, and DATE-FORMAT Verbs 


The TIME, SET-TIME, SET-DATE, and DATE-FORMAT verbs provide miscellaneous 


system information and capabilities. Figure A shows examples of these verbs. 


TIME 


The system time and date can be displayed on the terminal by entering the TIME 
verb. 


SET-TIME 

The SET-TIME verb changes the current system time. The general form is: 
SET-TIME hhimm{:ss} 

where "hh:imm' (seconds optional) is the time in 24-hour format. 

SET-DA TE 

The SET=DATE verb changes the current system date. The general form is: 
SET-DATE ddmmm{yy} or mm/dd{/yy} 

where "dd'' is the numeric day; "mmm'' is the three-letter month abbreviation 

(or two-digit month number in the second form); "yy" is the optional year 

specification. If not used, the current year displayed by the system is used. 


DA TE-FORMAT 


The DATE=FORMAT verb changes the form of dates printed with ENGLISH date 
conversions. The general form is: 


DATE-FORMAT {(1)} 


If the ‘I’ option is used, all dates normally displayed as mm/dd/yy are printed 
in European (international) format as dd/mm/yy, and the system assumes that 
external dates entered in formats such as mm/dd/yy are to be interpreted as 
dd/mm/yye The date format may be reset by entering DATE-FORMAT (without an 
option). 
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09:42:37 12 FEB 1983 


Figure Ae Examples of TIME, SET-TIME, SET=DATE and DATE-FORMAT Verbs 
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10.12 Information: WHERE and SLEEP Verbs 


The WHERE and SLEEP verbs provide miscellaneous system information and 


capabilities. Figure A shows examples of these verbs. 


The WHERE verb causes currently logged-on user assignments to be displayed. 
The general form is: 


WHEKE {n} {(options)} 


Columns in this display are line number, PUB FID, PIB Status byte one, followed 
py register one and the software return stack. An asterisk (*) next to an 
entry indicates assignments for the line which issued the verb. 

It "n" is specified, user assignments for line "n" are displayed. The “S$” 
option displays the number of process activations, CPU milliseconds, number of 
disc reads, PIB Status byte one and LINKS. The “A” option displays all lines 
including those not currently logged on; a question mark (?) ais printed next 
to ports that are logged off but do not have a status “/8° (an error 
condition). The “N” option inhibits automatic paging of output to the 
terminal. 

SLEEP 


The SLEEP verb sets a process to "sleep" for a specified period of time. The 
mechanism that allows a process to "sleep" is implemented in the MONITOR so 
that a "sleeping" process creates practically no overhead in the system. The 
“sleep” mechanism is useful for processes that must remain quiescent for a 
period of time. ‘he form of the SLLEP verb is: 


SLEEP n 
or 
SLEEP hhimm{:ss} 


where "n" is the number of seconds the process should sleep, or where “hh:ium" 
(seconds optional) is the time (in 24-hour format) when the process is to 
regain control. In either case, the terminal“s <BREAK> key may be used to wake 
the terminal. 
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PORT KIN STACK... 
XUV UZUU FU 121.0CB 121.072 
U3 0260 3C 104.070 164.066 


# ACTS CPU MSEC LINKS 
309197 320416 ; FE O8 
234 239 FEOF 
U 2440 FE FE 
49030 50979 OU FF 

QV 808728008 FE FE 

22 28 FE FE 


PORT > KIN STACK.. 
O03 U200 30 146.070 164.0660 


Figure A. Examples of WHERE and SLEEP Verbs 
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10.13 Information: LIMITS, USER, and DISCIO Verbs 


The LIMITS, USER, and DISCIO verbs provide miscellaneous system information and 


capabilities. 


LIMITS 


The LIMITS verb displays hardware configuration limits of the system. The 
general form is: 


LIMITS {(P)} 


This verb displays the system serial number, memory limit, ABS frame limit, 
communication ports limit, WORDMATE configuration (“Y’ for yes, ‘N’ for no), 
available devices (such as printer, tape, discs), and accessible frame numbers. 
The °P’ option directs output to the printer. This verb may be installed on an 
account with a SYS2 privilege level. 


USER 


The USER verb displays the system privilege level and number of logon workspace 
frames reserved for the line which executed this verb. The general form is: 


USER 
Note: The actual number of additional frames is the number displayed minus 
six frames. 
DISCLO 


The DISCIO verb creates a 5-=second "snapshot" disc activity report. 
Information displayed includes: 


l. Disc I/Os per second for each unit 

2. Total disc I/Os per second 

3. Number of disc reads per second 

4e Number of disc write/verify operations per second 
5. Cumulative disc I/Os per unit 

6. Cumulative disc I/0s 

7. Cumulative disc reads 

8. Cumulative disc write/verify operations 


where "cumulative" means the total number processed since the start of DISCIO 
execution. The general form is: 


DISCIO {(options) } 
If a numeric option is used, the display its repeated the specified number of 
times. The ‘’T’ option displays the current total disc I/O counters for each 
unit (i-e-, the number of disc I/0 operations since the last coldstart). The 
numeric option cannot be used with the “°T’ option. The °P” option produces the 
report on the printer. 


Figure A shows sample usage of above verbs. 
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SYSTEM SERIAL NUMBER 
OF MEMORY 
4194304 IS MAXIMUM FRAME-LD 
128 PORTS 
IS FIRMWARE TYPE 
IS FIRMWARE VERSION NUMBER 
WORDMATE 
AVAILABLE DEVICES 
DEVICE UNIT(S) 
TAPE(S) ie is 
PRINTER(S) 1,2,3,4 


2 SYSTEM PRIVILEGE LEVEL 
50 ADDITIONAL FRAMES OF WORK SPACE 


DEVICE I/0°S PER SECOND TOTAL 1/0°S 
bO 6.17 32 
Dl 7.13 
D2 7.22 
b3 3055 
TOTAL : 26.1 


READS : 16.1 
WRITES 3; 10.0 


DEVICE DISC UNIT I/07S 
bO 351762 
D1 327797 
b2 342781 
b3 338765 


Figure A. Sample Use of LIMITS, USER, and DISCIO Verbs 
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10.14 Setting Process Timeslices: TIMESLICE Verb 


This section describes how the SEQUEL system allocates timeslices among the 
various terminals. The TIMESLICE verb allows each line to be assigned a 


different timeslice to allow adjustment of task priorities. The SET-PRIORITY 
verb, previously used to adjust process priorities, no longer functions and if 
executed, it will be ignored. 


Each process (terminal) not waiting for an operator entry is placed on a queue 
of terminals waiting for activation. Activation means that the process is 
given a timeslice (or quantum) of CPU time in which to do its work. 


To determine which job to activate, the system scans from the top of the queue 
until it finds a job which can be activated. A terminal cannot be activated 
if: 


1. It is waiting for a frame to come in from disc 
2. It is "sleeping" 


A process which is activated continues to process until: 


l. It uses up its timeslice 

2. It references a frame which is not in main memory 

3. The program voluntarily deactivates 

4. The operator is prompted 

5. It references a frame to which I/O is being performed by a controller 


Priority is determined by a process’s position on the queue or "ladder". The 
position of processes changes as they use various system resources such as disc 
accesses and CPU processing. 


Normally, each process is assigned a 10 millisecond timeslice. The timeslice 
for each line is kept in main memory and current settings for each line stay in 
effect until a coldstart is performed, at which point the settings for all 
lines are set to 10 milliseconds. 


The form of the TIMESLICE verb is: 


TIMESLICE {n} { (options) } 


where "n'' ig a number (1-1023) indicating the timeslice in milliseconds. If 


"n"' ig omitted, the timeslice is displayed but remains unchanged. 


The timeslice for other lines may be changed or displayed from another terminal 
by specifying the line number in the option. For example, TIMESLICE 50 (3) 
sets the timeslice to 50 milliseconds on line 3, whereas TIMESLICE (3) displays 
the current timeslice setting for line 3. 


All of the process timeslices may be set or displayed by using the °A”’ option. 
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A point to remember in setting process timeslices is that setting a large 
timeslice on one or more lines may cause other processes to degrade because 
they may have to wait Longer for processing time. Setting timeslices too low 
may also cause degradation because processes may get "bumped off" before they 
get to do any meaningful work. 


You are eacouraged to experiment with different settings for your job mix, 
possibly changing timeslices within PROCs that activate certain jobs. 


TIMESLICE {n} { (options) } 


Figure A. General Form of TIMESLICE Verb 


————— Pieplays current timeéslice. 
TIMESLICE FOR LINE 10 EQUALS 100 MILLISECONDS 


—t—————- Sets timeslice to 25 mtllteeconds. 


————_-+_-— Displays timeslice for tine 3. 
TIMESLICE FOR LINE 3 EQUALS 75 MILLISECONDS 


1 t——--———— Sets timeslice for line 3 at 50 milliseconds. 


t———— Sets timeslice for all Lines at 
mtLLiseconds. 


Figure B. Sample Usage of TIMESLICE Verb 
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10.15 Available System Space: POVF and CIAIM Verbs 


The POVF verb displays the number of frames in the four "available space" 


tables. The CIAIM verb returns linked available space to contiguous available 
space. 


CIA Tl 


The CLAIM verb converts linked space to contiguous space. CIAIM can run while 
other processes are running. The general form (Figure A) is: 


CLA IM 


CIAIM sorts the FIDs of the linked frames and determines if there are any 
consecutive frames that could now make up a contiguous block. If so, the block 
is placed in the contiguous space table (attached to an existing block if 
possible). Then the individual frames are inspected to see if they can now be 
attached to existing contiguous blocks. The remaining frames (if any) remain 
in linked form and the POVF display is printed. 


POVF 
The POVF verb (Figure A) has the following general form: 
POVF {(P)} 


POVF displays the number of frames in the four "available space" tables. If 
there are any frames in the linked chain of file space, the first line of 
output contains the FID of the beginning frame in the chain. The "TO" field 
contains the word "LINKED" and the "“#FRAMES" field contains the total number of 
frames in the linked chain. Contiguous file space is displayed with the 
beginning and ending FIDs of each block and the total frames in the block. 
Lines of output after the linked chain information are in the form: 


m-n p ma-n p 


is the first frame of a contiguous block 

"n'' is the last frame of the block 

p" is the number of frames in the block 
Following the contiguous frame display is the total number of contiguous file 
space frames. Also listed are the number of frames in the temporary space 
block and the temporary space chain. 


The “P’ option directs output to the printer. 


Figure B illustrates usage of POVF and CIAIM verbs. 
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se 


CLAIM  —~—<+———__—_—___—— Reelaims linked overflow space 


POVE {(options)} ~——~ Prints overflow list 


P - Output to printer 


tigure A. General Form of POVF and CLAIM Verbs 


FROM TU #EFRAMES FROM TO #FRAMES 
54872 LINKED 5 

5622 - S7LL YOU 6427 = 6440 14 
25805 ~ 25806 2 35700 - 35707 8 
35712 = 35714 3 35718 - 35725 8 
36566 - 36595 30 36680 - 36694 15 
360699 = 36916 18 360931 - 36939 9 | 
30959 - 364965 / 37736 - 37737 2 
3374U - 37751 12 38557 - 38570 14 
38584 - 34596 13 39290 ~ 39291 2 
53930 - 53993 58 54000 - 54007 8 
54016 - 54026 ll 54033 - 54042 10 
54049 = 54228 180 54373 - 54384 12 
54413 - 54793 381 54841 - 54853 13 
54914 - 54922 y 54924 - 54927 4 
54937 - 54937 L 54960 = 54960 L 
54904 = 54978 lu 55038 - 55045 8 
55399 - 59578 lsu 55957 - 58463 2507 


TOTAL NUMBER UF CONTLGUOUS FRAMES = 36040 
NUMBER OF FkAMKS IN THE TEMPORARY SPACE BLUCK 
NUMBER OF FRANKS IN THe TEMPORARY SPACE CHAIN 


ueoa 
le 
reo 


a Produces same output as POVF 


Figure B. Sample Usage of POVF and CLAIM Verbs 
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10.16 Generating Checksums: CHECK-SUM Command 


The CHECK-SUM command generates a checksum for file items; from this you can 


determine if data in a file has been changed. 


CHECK-SUM is an ENGLISH verb (Figure A) which has the following general form: 


CHECK-SUM {DICT} file-name {item-list*} {attribute} {selection-criteria} 
{ (options) } 


A checksum is an arithmetic total, disregarding overflow, of all bytes in the 
selected item(s) and is generated for items in the specified file, or subset of 
items if the optional "“item-list" and/or "selection-criteria" appear. 
Furthermore, the checksum may be calculated for one specified attribute. If no 
attribute is specified, the first default attribute is used. If there is no 
default attribute, or if the AMC is 9999, the entire item is included. The 
checksum includes the binary value of each character times a positional value. 
This yields a checksum which has a high probability of being unique for a given 
character string. The dictionary portion is checksummed if the "DICT" option 
appears. The °P” option may be used to direct output to the printer. 


A message is output, giving checksum statistics, in the following form: 


BYTE STATISTICS FOR file-name (or attribute name): 
TOTAL = t AVERAGE = a ITEMS = i CKSUM = c BITS = b 


where: 
"et" is the total number of bytes in the attribute (or item) included 
"a" is the average number of bytes per item 
"i" is the number of items 


"o" ais the checksum 


"bd" is a bit count 


The attribute mark trailing the specified attribute (or item) is included in 
the statistics. 


Sample output statistics are shown in Figure 3B. 


To use checksums, you should issue CHECK-SUM commands for all files, or 
portions of files, to be verified and record the output statistics. 
Subsequently, the CHECK-SUM commands can be reissued to verify that the 
checksum statistics have not changed. The checksum for a given file must be 
recalculated whenever you update that file. 


* The item-list can be supplied by a previous SELECT, SSELECT, GET-LIST or 
FORM-LIST command, in which case the selection-criteria is omitted. 


230 . 83-1109 


LU) SPECLAL SYSTEM UTILITIES 


CHECK=SUM {DICT} 1tile-name {item-list*} {attribute} {selection-criteria} 
{(options)} 


Specistes Specifies || Spectftes attribute Limite P - Output 
file eligible used to caleulate eligtble to 
ttems cheeksum ttems printer 


Figure A. General Form of CHECK-SUM Verb 


BYTE STATISTIVUS OF TEST : 
TUTAL = 70 AVEKAGE = 7.00 [TEMS = LU CKSUM =38444 BITS =245 


ee ea «| Update Fite 


“137 DELETED 


Note changed stattstics 


BYTE STATLSTLUS OF Trst : d 
YOTAL = 63 AVERAGE = 7.00 L[TEHS = 9 CKSUM =35007 BITS =220 


BYTE STATISTICS OF NEXT-ACCOUNT : 
TUTAL = 392 AVERAGE = 5.76 ITEMS = 68 CKSUM =148837 BITS =1484 


(D/Code will be used stnee it tis a 


 defaubt attribute -- item '1') 
BYTE STATISTICS OF D/CODE 3: 


TOTAL = 183 AVERAGE = 1.96 [TEMS = 93 CKSUM =53070 BITS =888 


enone 


Figure B. Examples of CHECK-SUM Verb 


é3-llug 231 


10 SPECIAL SYSTEM UTILITIES 


10.17 Group Format Errors: FIX-FILE-ERRORS Verb 


The FIX-FILE-ERRORS verb is designed to assist SEQUEL users in determining the 


nature of group format errors they have encountered. In many instances the 
program will recover data which would previously have been lost. 


The FIX-FILE-ERRORS verb can be misused! It should be used only by experienced 
users, and then only after a cautious examination of the situation. 


The general form of this verb (Figure A) is: 
FIX-FILE-ERRORS {DICT} file-name 


You should be logged on to an account with 66 frames of additional work-space. 
The TSYM file must be defined on this account. 


The FIX=-FILE-ERRORS verb operates on either the data or dictionary portion of a 
file. This operation is performed on each group until all groups have been 
processed.s When possible, the operation will remove data in error and place it 
in the dictionary of the TSYM file. 


Two passes are made through each group. Pass one verifies the frame linkages 
of the group, and pass two examines the data. 


Pass one first checks the links of the primary file space. Errors are reported 
in the following format: 


LINK FLELD ERROR - GROUP n FRAME n 
LINKS xX XXXX KKKX XX 


If the primary space crosses the maximum FID, the program stops with an 
appropriate message. After processing the primary space, the operation scans 
links of secondary frames searching for an incorrect backward link and for the 
end of group. If an incorrect backward link is found, the program scans (at 
most) another 66 frames in that group. 


Pass two scans the data one item at a time. Items are examined for format 
errors, described in Figure B. Corrective actions for these errors also are 
listed in this figure. 


If segment marks are encountered, they are relaced with backarrows (_)» A 
message of the form "SM @ xxxx.yy" is displayed, where xxxx-yy is a frame and 
displacement. Error items built in the TSYM dictionary are given special 
item-ids. The item-id is composed of: 


Errot type, FID of first frame in group, sequential integers 


Note that subsequent use of this program or the assembler causes the error 
items to be lost because TSYM is cleared! 
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FIX~FILE-ERRORS {DICT} file-name 
a 
Figure A+ General Form of FIX-FILE-ERRORS Verb 


CORRECTIVE 
DESCRIPTION ACTION TAKEN 


0 Premature end of data * 
N Nonhex character in count field 

Count field out of range (was <5 or >32267) 

No attribute mark at end of item 

An item-id exceeds 50 characters 


An item-id does not hash to current 
group 


(none) A segment mark was found in the item 
*A new item is created in the TSYM dictionary and a group-terminating 


attribute mark is placed after the last good item. Any secondary frames 
beyond the last item are disconnected from the group. 


**Offending items are removed from the file and placed in the TSYM 
dictionary. The scan continues through the group. 


Figure B. Errors Detected and Corrective Action Taken by Pass 
Two of FIX=-FILE-ERRORS 
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10.18 Source Compaction: ECOPY, EEDIT and EBASIC Verbs 


This topic describes the SEQUEL system capability to maintain source programs 


in a compacted form. 


You may compact source code (for DATA/BASIC programs) so that the source 
programs take less file space. The compaction is achieved with only a slight 
decrease in processing speed during editing, compiling, etc. Compaction is 
achieved by replacing any sequence of three or more blanks or asterisks with a 
delineator, a count of the number of characters compacted, and the character. 
The delineator used is the data link escape character (DLE, X%10’). 


The compaction takes place when an item is written into a file using the ’FI’ 
command of the EDITOR (see the EDITOR Programming Manual). This processor is 
the only one which is able to compact data. The EDITOR can also expand the 
data during the time it is being edited (i.e., while in the IS and OS work 
areas). In addition to the EDITOR, the DATA/BASIC compiler and COPY process 
evoke the expansion feature. Note: The assembler does not recognize this 
feature. 


To use this feature, you must specify one of these new verbs in your TCL 
statement. 


Note that the ECOPY verb will expand items as they are copied. Since this is 


usually not what is desired, you should, in general, use the normal COPY verb 
when copying compressed items. 
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10.19 File Management PROCs: DELETE and SET-FILE 


DELETE and SET-FILE are two PROCs available for file management. 


DELETE PROC 


This PROC is evoked by typing: 

DELETE file-name {item-id} 
This PROC deletes the specified item. If an asterisk (*) is used in place of 
an item-id, the item-ids will be supplied by a SELECT, SSELECT, GET-LIST, or 
FORM-LIST. If no item is specified, the message "NEXT ITEM" prompts you for an 
item-id. A carriage return ends the input prompting. 


SET-FILE PROC 


The SET-FILE PROC provides a quick way to set up a file synonym definition item 
(Q-pointer) to any file in the system. The general form is: 


SET-FILE {account-name {file-name}} 
where "“account-name" is the name of the logon account the file is defined in, 
and "file-name" is the name of the file that a Q-pointer is to be set up for. 
SET-FILE always returns. the message: 


QFILE UPDATED 


indicating that an item called "QFILE" has been set up in the M/DICT asa 
Q-pointer to the required file. For example: 


QFILE UPDATED 


This example sets up QFILE to the XSYM file in SYSPROG. 


Typing SET-FILE with one or both parameters missing will cause a request for 
that parameter; 


ACCOUNT=NAME 
FILE-NAME? 
“QFILE UPDATED’ 


This example causes the same action as the previous example. Typing a null 
line to either the request for "ACCOUNT-NAME?" or "FILE-NAME?'" leaves the 


corresponding name in the ’QFILE” item unchanged from its previous value. 


Figure A shows the general form of DELETE and SET-FILE PROCs. 
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DELETE tile-name {item-id}~q———___—_ De Letee item(s) 


SET-FILE {account-name {file-name}} ~«— Creates Q-pointer 


Figure A. General Form of DELETE and SET-FILE PROCs 
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10.20 Printronix Printer Adjustments: PRINTRONIX Utility 


A cataloged utility program called 'PRINTRONIX" enables you to change the form 
length and number of lines per inch on the Printronix printer. 


This utility is executed from the SYSPROG account by typing "PRINTRONIX" at 
TCL. Upon its execution, you are prompted for the form length, number of lines 
per inch, and channel specifications. After you enter your responses to the 
prompts, the utility transmits the necessary control characters to the printer. 


NOTE: The data is sent to the printer as a "normal" print job (i-e., job is 
placed in the job queue). Therefore, any changes caused by the 
PRINTRONLX utility will not take effect until the other print jobs ahead 
of it are printed. Remember, you have the option of changing the 
priority of print jobs via SP-JOBS Action Code 10 and SP-PRIORITY verb. 


The PRINTRONLIX utility also allows you to equate IBM "channel" numbers with a 
particular line number. For example, if Channel Three is equated to Line Six, 
the printer moves to the sixth line when a "Skip to Channel 3" command is sent 
to the printer. This feature is used only when receiving print format data 
from an IBM system via the 5750 Communications Terminal. 


On the adjacent page you see two examples of PRINTRONIX usage. In Figure A, 
the user is specifying a form length of 11 inches and 88 lines per page (11 x 
8). Note that the '8 LPI" button must still be pressed if eight lines per 
inches are desired. 


In Figure B, a user is specifying a form length of 11 with 66 lines per page. 
In addition, two channel specifications are made. When this utility is 
executed, a "Skip to Channel 3" command moves the paper to the sixth line; a 
"Skip to Channel 4" command moves the paper to Line 33. Note that Channels 1 
and 2 are reserved. 
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ENTER FURM LENGTH LN LNCHES 


15 Tals 6 OR 8 LINES PER INCH? 
VFU CHANNEL SKIPS (Y/N) 


NOW SEY PRINTER TO 6 OR 6 Lel AND ADJUST FORMS IN PRINTER. 


Figure A. sample Usage of PKINTRKONIX Utility (Without Channel Specification) 


ENTER FORM LENGEH £N LNCHES 

is THls 6 OR & LINES PER LNCH? 
VEU CHANNEL SKLPS (Y/N) 

CHANNEL L USED AS TUP-OF=FORM 
CHANNEL 2 USED AS DUMMY CHANNEL 
CHANNEL, LINE 


PRINTER TU 6 UR 8 LPL AND ADJUST FORMS IN PRINTER. 


Figure B. Sample Usage of PRINTRONIX Utility (with Channel Specification) 
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10.21 Miscellaneous PROCs 


This topic describes various utility PROCs. 


CT PROC 


This PROC is evoked by typing: 
CT file-name item-list* or * {(options)} 


The item(s) specified are copied to the terminal. Options recognized by the 
COPY verb may be added. 


CP PROC 
This PROC is evoked by typing: 
CP {file-name} {item-list* or *} {(options)} 
The item(s) specified are copied to the printer. If the file-name and/or items 
are not specified, they are prompted for. Options recognized by the COPY verb 
may be added. 
CHOO-CHOO PROC 
The CHOO-CHOO PROC is evoked by typing: 
CHOO-CHOO . 


funy PROC prints a picture of a choo-choo train on your terminal (just for 
fun). 


LISTACC PROC 
The LISTACC PROC is evoked by typing: 

LISTACC {account-names} {LPTR} {NOPAGE} {(options) } 
This PROC lists accounting data for the account-names specified. If no 
account-names are specifie accounting data for all users are listed. Any 
valid ENGLISH options (described on facing page) may be included. Output is 
paged to terminal unless defeated. 
LISTCONN PROC 
The LISTCONN PROC is evoked by typing: 

LISTCONN {file-name} {LPTR} {NOPAGE} {(options)} 
{his PROC sorts all connectives in the M/DICT or optionally specified file. 
LISTDICTS PROC 


The LISTDICTS PROC sorts all attribute or attribute synonym definition items in 
the M/DICT or the optionally specified file. The general form is: 


LISTDICTS {file-name} {LPTR} {NOPAGE} {(options)} 

LISTFILES PROC 

The LISTFILES PROC sorts all file and file synonym definition items in the 
M/DICT or optionally specified file. The PROC displays the D/CODE of the file 
entry, the MODULO, SEPARATION, and BASE FID of the dictionary portion of the 
file, the number of ACCESS and RETRIEVAL codes, any correlatives, the output 
type (i: r, ¢, etc.), and the ae ets length. The last three operate on the 
item-ids of the data items during ENGLISH output. The general form is: 


LISTFILES {file-name} {LPTR} {NOPAGE} { (options) } 
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LISTPF PROC 
The LISTPF PROC sorts the POINTER-FILE and produces a report displaying the 
account-names, types of cataloged items (C=cataloged TDATA/BASIC program; 
L=save~list of item-ids/data), the names of the programs or lists, the FID of 
the first frame of the information, the number of frames occupied, the number 
of item-ids (or attributes if cataloged data) for save-lists, and the catalog 
date. The general form is: 

LISTPF {LPTR} {NOPAGE} { (options) } 
LISTPROCS PROC 


LISTPROCS sorts all PROCs in the PROCLIB file or optionally specified file. 
The general form is: 


LISTPROCS {file-name}> {LPTR} {NOPAGE} { (options) } 
LISTU PROC 


The LISTU PROC lists the account names of all users currently active on the 
system, along with their PCB=FID, location, logon time and channel number. 


The location field is stored as Attribute 1 in items with item-ids equivalent 
to the two digit channel number in the dictionary of the ACC file. 


LISTVERBS PROC 


The LISTVERBS PROC sorts all verbs (not PROCs) in the M/DICT or optionally 
specified file. The general form is: 


LISTVERBS {file-name} {LPTR} {NOPAGE} { (options) } 
LP80, LP106, LP136 PROCs 


The LP-type PROCs set the terminal characteristics so printer listings will be 
formatted for paper of the following sizes: 


LP80 8-1/2" wide by 11" long 
LP 106 11" wide by 8-1/2" long 
LP136 14" wide by 8-1/2" Long 


N -~ Inhibit paging of terminal output (NOPAGE) 


P - Produce listing on printer (LPTR) 


Figure A.» Valid ENGLISH Options 


$3-L10Y 241 


10 SPECIAL SYSTEM UTILITLES 


10.22 Miscellaneous PROCs 


This topic describes additional utility PROCs. 


FLIP PROC 


The FLIP PROC presents a general feature listing and overview of SEQUEL 
concepts in a flip-chart format on the terminal. Subjects outlined on the 
terminal describe ENGLISH, PROC, SEQUEL file structure, etc. The demo outline 
is included for illustrative purposes only. The actual programs to execute a 
demo are not included and are left up to you. 


SPACE PROG 


The SPACE PROC may be used to perform multiple T-FWD commands to skip over a 
specified number of tape files. You must first attach the tape with the T-ATT 
verb. To execute this PROC, enter the word SPACE and the system will prompt 
for the number of files to T-FWD over. 


COMPARE PROC 


The COMPARE PROC compares items in two different files. Output includes the 
number of items in each file, a list of items that do not compare, and a list 
of items that are in one file but not the other. To execute the COMPARE PROC, 
enter the command COMPARE. The PROC prompts for the two file-names and asks if 
output is to be to the terminal or printer. 


CHECK PROC 

The CHECK PROC is similar to the SPACE PROC except that multiple T-CHKs are 
performed, checking a number of sequential tape files for parity errors. You 
must first attach the tape with the T-ATT verb. 

GAMES 

The Microdata SYS=GEN (initial system loading tape) contains a BP (DA TA / BASIC 
program) file containing a number of sample games. Refer to the appropriate 
release installation instructions for the location of the file on the tape, and 


the loading procedure. 


Figure A illustrates the sample usage of SPACE, COMPARE and CHECK PROCs. 
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{1021} UNI1(#1) ATTACHED, RECORD SIZE = 512 


SPECIFY NUMBER OF TAPE FILES TO T-FWD 
MUST Bh TWO DIGLTS= 
U3 

[94] BND OF FILE 

Uz 

[94] EWo OF FLué 

Ul 

[94] END OF FILE 
«+eYUU ARE SPACED OUT... 


ENTER FIRST FLLE TU COMPARE ( [DICT] FILE-NAME ): 
ENTER SECOND FIub ‘TO COMPARES 
DO YOU WANT OUTPUT LO THE PRINTER (Y/N) 


FILE COMPAKISON BETWEEN “AA” AND 7 BB~ 
PAGE 1 13:15:32 12 FEB 1983 


{TE COUNTS: “AA%: 36 "BB": 35 
123-AA DOKS NOT MATCH 

1453-AC Ib wllSSING FROM BB 

1632-ES IS MISSING FROM Bu 

8821-GG [5 MISSING FROM AA 


e-- FINISHED --- 


SPECIFY NUMBER OF T, 
MUST BE TWO DIGITS=1 
U2 

[94) END OF FILLE 
v1 

(94] EN) OF FILE 


«+eYOU ARE CHECKED OUT... 


Figure A. Sample usage of SPACE, COMPARE, and CHECK PROCs 
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11.1 System Programming (SYSPROG) Account 


Several special facilities are normally used from the System Programmer 


(SYSPROG) account. Procedures on this account are normally performed by 
persons more familiar with the overall operation of the system. 


To log on to the SYSPROG account, when the message (or similar prompt): 
LOGON PLEASE: 


is displayed, type: 


where “password” is the appropriate password set up for SYSPROG. Alternate 
logon names (such as SP, which has no additional work space frames) may be 
used. 


Figures A and B show some of the common verbs and PROCs available on the 
SYSPROG account. 
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SYSTEM MAINTENANCE PROCEDURES: 


: ABSLOAD 


: ABS/FILES 


ACCOUNT-RESTORE 
BUFFERS 
CHARGE-TO 
DE-COPY 
DE-RESET 


DE-START 


ACCOUNT~SAVE 
ALL-FILE-STATS 
CREATE-ACCOUNT 


FILE-SAVE 


SETUP~ASSY 


63-1109 


Figure A. 


Figure Bb. 


SYSPROG ACCOUNT 


Some SYSPROG Verbs 


Some SYSPROG PROCs 


DE-STOP 


DSKAD 


: FILES 


LOCK~FRAME 


MEM-DIAG 


SAVE 


SEL-RESTORE 


STRIP-SOURCE 


UNLOCK-F RAME 


SYS-GEN 


SYS-UPDATE 


SYS TEM-SETUP 


UPDATE-ACCOUNT 


VERIFY-SYSTEM 
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11.2 Minimizing Data Loss During Restores: SET-WRITES Verb 


The SET-WRITES verb flushes write-required memory buffers. . Use of this verb 


minimizes data loss during a coldstart and ABS restore. 


Because of SEQUEL“s large main memory size, it is possible that the system is 
waiting an inordinate amount of time before copying write-required buffers to 
disc. This may result in a loss of data in the event a coldstart or ABS 
restore is performed. To avoid such losses, the SET-WRITES verb is designed to 
enforce the writing of write-required buffers to disc at a user-defined rate: 
write-required memory buffers are written to disc after a specified number of 
port activations, regardless of buffer usage. These buffers are flushed in 
sequential order (i-e., after the first “set” of activations, the first 
write-required buffer is flushed; after the second "set" of activations, the 
second write-required buffer is flushed, etc.). 


The format of the SET-WRITES verb is: 
SET-WRITES k 


where “k” is a decimal number between 1 and 2,147,483,646 that specifies the 
number of activations between each disc write. This number is reset toa 
default value of 2,147,483,646 when a coldstart is performed. 


Listed below are some guidelines you should consider before using the 
SET-WRITES verb: 


1. If your system rarely needs to be coldstarted, the SET-WRITES verb is 
probably not. needed. 


2. If your system is coldstarted regularly and 


a. if you run large applications (large in terms of main memory usage) 
and key in small amounts of data, set “k” to a high number 
<o7n= 
b. if you run "tight" programs (those that use a minimum of main 
memory) and key in large amounts of data, set “k” to a low number. 


It is not possible to apply a fixed "correct" value to the SET-WRITES verb 
because you begin to see degradation of response time as “k” is lowered. The 
number of users on the system at any given time, the type of processing, and 
the frequency of coldstarts are all considerations. Thus, a value judgement 
must be made by the person responsible for the system. 


A basic setting used at many system sites is a value of 20,000. At the very 
least, this can be a starting point. The number can be varied at different 
times of day, or varied on a daily basis. Use of: the BUFFERS verb with the “T~ 
option gives you the total number of write-required buffers. 
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The following restrictions apply to the SET-WRITES verb: 


1. The SET-WRITES verb must be executed from SYSPROG. 
2. You must have SYS(2) privileges. 


To better understand the way that a given SET-WRITES setting may affect the 
operation of your system, we suggest you use one of the following formulae: 1) 
calculate how long it will take to cycle through main memory with a given 
SET-WRITES setting or 2) calculate the correct SET-WRITES setting to achieve 
one complete cycle through main memory in a given amount of time. Both 
formulae are described and illustrated in the following two topics. 


Figure A illustrates the format of the SET~WRITES verb. 


SET-WRITES k 


Figure A. Format of SET-WRITES Verb 
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11.3. Using SET-WRITES Formula #1 


Formula #1 calculates a SET-WRITES setting (“k~). This topic describes the 


equation to calculate “k” and illustrates the use of the formula in Figure A. 


Before you can use either Formula #1 or #2, a series of system-dependent 
variables must be defined: 


ATS = Average of timeslice values of system processes. 

KBUF = 2 * total megabytes of main memory. 

NDISC = Total number of disc drive units. 

AVXRT = Average disc 1/0 transfer rate (i.e., AVXRT represents an 
approximation of the maximum throughput, in frames/buffers per 
second, that the disc sub-system can handle), to be calculated by 
the following formula: AVXRT = (50-(NDISC*5))*NDISC. 

MINT = Minimum cycle time, in seconds, in which KBUF can be flushed to 
disc; use this formula: MINT = (KBUF/AVXRT)*1000. 

™ = Actual Cyle Time, in seconds. This will either be the time it 
takes for one complete cycle through main memory, or the amount of 
time that a complete cycle through main memory will take with a 
given SET-WRITES value. Note that TM is simply a time value in 
seconds that cannot be less than MINT. 

k = The value of SET-WRITES. 


FORMULA #1: DETERMINING A SET-WRITES SETTING (“k~) 

This formula calculates the value for the SET-WRITES setting (“k”) when it is 
desired that SET-WRITES make a full cyle through memory in a given time. To 
ensure that the time given (TM) does not exceed the saturation point of the 
disc sub-system transfer rate (AVXRT), TM cannot be less than MINT. 

To calculate “k”, follow these steps: 


lL. Solve for AVXRT, then MINT. 


2. Convert the desired cycle time to seconds. This is TM. If TM is less 
than MINT, then round Tif upward to MINT (TM cannot be less than MINT). 


3. Now solve for “k*: k = TM/(ATS*KBUF). 
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Parameters used in this example: 


1 Megabyte of main memory: KBUF = 2%1 = 2 
10 Milliseconds average timeslice: ATS = 10 
2 REFLEX-II dise drives: NDISC = 2 


STEP 1. Calculate AVXRT and MINT: 


AVXRT = (50-(NDISC*5))*NDISC 
= (50-(2%5) )*2 
(50-10) *2 
80 (transfers per second) 


= (KBUF/AVXRT)*1000 
(2/80)*1000 
»025*1000 

= 25 (seconds) 


Calculate the SET-WRITES setting (“k*) from a given time of TM. 


For this example, lets say that we want to cycle through memory every 
30 minutes. 


™ = 30 minutes * 60 seconds 
1800 seconds 
NOTE: If TM < MINT then TM = MINT. 


= TM/(ATS*KBUF) 
1800/(10*2) 
1800/20 

= 90 


Thus, with the given parameters and the desire to cycle through memory every 30 
minutes, the SET-WRITES setting would have to be 90. 


Figure A. Sample Use of SET-WRITES Formula #1 
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11.4 Using SET-WRITES Formula #2 


Formula #2 calculates the amount of time it takes for a full cycle-through of 


main memory given a SET-WRITES value of “k”. This topic describes the equation 
to calculate TM and illustrates the use of this formula in Figure A. 


To calculate IM, follow these steps: 
1. Solve for TM as follows: 
TM = k*ATS*KBUF 


NOTE: If TM < MINT then TM = MINT. 


2. Use TM as the number of seconds it will take to perform a full 
cycle-through of main memory with a SET-WRITES setting of “k”. 


NOTE: If a SEQUEL system goes into an idle state, where the condition is such 
that virtual processes are not being activated for some period of time, 
all buffers in main memory that are ina write-required state will be 
written out to disc by the system Monitor. The elapsed time over which 
this process will be completed is equal to or less than the value 
calculated for the MINT variable. There is a high probability that this 
process will take less time than MINT depicts because the value 
calculated for AVXRT is based on an I/O transfer rate for the disc 
sub-system that tends to be on the modest side. 
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Parameters used in this example: 


1 Megabyte of main memory: KBUF = 2*1 = 2 
10 Milliseconds average timeslice: ATS = 10 
2 REFLEX-IL disc drives: NDISC = 2 


STEP 1. Calculate AVXRT and MINT: 


AVXRT = (50-(NDISC*S))*NDISC 
= (50~(2*5))*2 
= (50-10)*2 
= 40*2 
= 80 (transfers per second) 


= (KBUF/AVXRT)*1000 
= (2/80)*1000 
= .025*1000 

25 (seconds) 


Calculate the approximate time it would take SET-WRITES to enforce one 
complete cycle-through of main memory given the SET-WRITES setting 
(“k"). 


Let”s say that the SET~WRITES setting “k” is 10000. 


kK*ATS*KBUF 
- LQUOO*1LO*2 

LOO0U00*2 

200000 seconds 

NOTE: If TM < MINT then TM = MINT, 


T™ 


u 


Convert TM (the actual time in seconds) to minutes and/or hours: 


CYCLE TIME IN MINUTES = TM/60 
200000/60 


3333.3333 minutes 


Thus, with the given system parameters and the SET-WRITES setting of 10,000, it 
would take 3333 minutes, or a little over two days (55.5555 hours), for 
SET-WRITES to cycle-through memory one time. 


Figure A. Sample Use of SET-WRITES Formula #2 
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11.5 ACCOUNT-SAVE PROC 


The ACUOUNT SAVE PROU on SYSPROG allows you to save one account on tape. 


This PROC functions similarly to the FILE-SAVE PROC, except the “I” option of 
the SAVE verb is used. Wo coldstart or ABS section is created. The general 
form of the input line is: 


ACCOUNT=SAVE {(T)} 
After entering the ACCOUNT-SAVE PROC, you see the prompt: 

ACCOUNT NANE=? 
kespond to this prompt with an account name represented by a D-pointer in the 
SYSTEM Dictionary. Wo synonym Q-pointers in the SYSTEM Dictionary are saved. 
The STAT-FLLE is cleared and loaded with statistics for only the specified 
account. A T-DUMP of the STAT-FILE is appended and the file statistics report 
are printed. Use the “T” option to inhibit the writing of a tape label at the 


beginning of the files section. 


Figure A illustrates the ACCOUNT=-SAVE PROC. 
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09:33:00 O07 APR 1983 


TAPE RECORD BLOCK LENGTH LF OTHER THAN 512? Produces default of 512 
[1021] UNIT(#1) ATTACHED, RECORD SIZE = 512 bytes 
[94] END OF FLLE 


START PASS] -- WRITE THEN READ 20 RECORDS OF X755AA55AA7 
START PASS2 ~~ WRITE THEN READ 20 RECORDS OF X*U0OFQOFFO” 
TAPE READ AND WRITE COMPLETE WITH NO ERRORS 


TAPE LABEL IF DESIRED ——_ Specifies tape tabel 
tdenttftication 


+ « » START ACCOUNT SAVE . 


ACCOUNT NAME = 
ACCP 


—_——_—_______—__—_———_ Account name 


e 


[99] 85 TAPE RECORDS WRITTEN. 
+ « » END OF ACCOUNT SAVE. . . 
- « » DUMPING STAT-FILE . . . 


67 ITEMS DUMPED. 


+ « » PREPARING FILE STATISTICS REPORT... 


Figure A. Dialogue for ACCOUNT=SAVE PROC 
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1l.o6 Account-Restores 


The ACCOUNT-RESTORE verb adds a new account (from tape) to an existing system. 


ACCOUNT=KESTORE 


An account-restore can be performed from a formatted file-save of a whole 
system or from a save of a single account (Figures A and 8). In either case, 
the entire account is restored and a pointer to the account is created in the 
SYSTEM Dictionary. To use ACCOUNT-RESTURE, mount the tape at load point and 
select one of these methods, depending on the type of tape being used. 


A. For full file-save tapes, follow these steps: 


1. Attacn the tape with the proper record size. 
2. is present, enter: 


n is present, enter: 
ioned at the files section, type: 


o. Answer the prompt “ACCOUNT-NAME?" with the name of the account. The 
account hame must be the same name used on the file-save tape. 


B. For single account-save tapes, follow these steps: 


1. Attach the tape with the proper record size. 
2. Enter: 


The restore will procede automatically. 


Do not restore an account whose name matches any item in the System dictionary. 


This means that you must delete an old account before restoring another account 
with the same name. If desired, a Q- pointer in SYSPROG*s M/DICT to the new 
account may be added. 


“A “synonym” segment may be encountered with a base which has not been found on 
the tape. This happens if a D-pointer on the saved account points to a file on 
another account (illegal use of multiple D-pointers), or if a “DB” segment oa 
the tape is wumrecognizable because of a parity error. In this case, the 
message 


“SYNONYM NOT FOUND? 


appears, and no D-pointer is created. 
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[1021] UNIT(#L) ATTACHED, RECORD SIZE = 8192 


——_____—_————- Reads label preceding account 
DOC .ACCT]08:01:33 Ol JUL 1982 


+—_—_--——__ Initiates acecount-restore 


STATUS 11137,17,1 
ERRORS 11154,1,1 
DL/ID 11155,3,1 
m/DICT 11137,17,1 (8S) 
DL/ID 11137,17,1 (S) 
TP 11159,1,1 
DL/Iv 11160,7,1 
PARCEL 11306,3,1 
DL/ID 11309, 503,1 


—__-__---__—_—___—_—— Returns to TCL when finished 


Figure A. Account-Restore from Account-Save Tape 


[1021] UNIT(*1) ATTACHED, RECORD SIZE = 8192 


+—___—___\___———_- Bypass coldstart section 
[94] END OF FILE 


—<+________— Reads label preceding ABS section 
DOC.ACCTJO8:01:33 Ol JUL 1982 


LABEL 


: ~<+-—_______——————- Bypass ABS seetton 
[¥4] END OF FILE 


——-—-—— [nittates account-restore 


ACCOUNT NAME? 
STATUS 11948,17,1 
ERRORS 11905,1,1 
DL/ID 11966,3,1 
u/DICT 11948,17,1 (8) 
DL/LD 11948,17,1 (S) 
TP 11970,1,1 
DL/ID 11971,7,1 
PARCEL 12117,3,1 
DL/ID 12120,503,1 


—<+——_ _ Prompts for destred account 


+H Heturne to TCL when finished 


Figure B. Account~Restore from Complete File-Save Tape 
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11.7 Selective-Restores 


The selective-restore capability allows individual files or items to be loaded 


onto the system from a formatted file-save tape. 


SELTRESTORE 


This verb restores a file from a formatted file-save or account~save tape 
(figure A). sefore using SEL-RESTORE, the tape must be positioned correctly. 
Mount the tape at load point and select one of these methods, depending on the 
type of tape being used. 


A. For full file-save tapes, follow these steps: 


1. Attach the tape with the proper record size 
2. ff a bootstrap is present, enter: 


3. Now enter 


4. If an ABS section is present, enter: 


B. For single account-save tapes, follow these steps: 


l. Attach the tape with the proper record size 
2. Enter: 


Wow that the tape is positioned at the beginning of the files section, enter: 
SEL“RESTORE file-name item-list or * {(options)} 


where "“file-name" is the file on the system in which items will be placed. 
This file must be defined on the account from which the restore is run. 
"Item-list” is the list of items to be restored. An asterisk (*) may be used 
to indicate all items on the tape file. You are then prompted for: 


ACCUUNT NAME? a-name 
FLLE NAME? f-name 


where “a-name"” is the name of the account under which the file was saved on 
tape, and “f~name" is the name of the file as it appears on the tape. Entering 
<cr> to FILE NAME? causes the account Master Dictionary to be restored. 
“F-name" may be of the format “file”, “DICT file“ or “file DL/ID“ or “file 
zzzz° where “gzzz" is a D~pointer in the dictionary of “file”. 


250 83-1109 


ll SYSTEM MAINTENANCE PROCEDURES: SYSPRUG ACCOUNT 


Applicable options are: 


6) Overlay items already on the file if they have the same item-ids. 
A The tape is already positioned in the desired account. 
N File is to be identified on tape by its file number, in which case the 


Prompt will be “FILE#?". The required file number is the one which 
accompanies the file on the file statistics printout for the 
appropriate file-save (under the column labeled “ORDER"). 


c This option must be used with the “N” option. It causes every item 
before the next end of file to be a candidate for restore. This 
ensures data can be restored even if a D-pointer on tape is damaged. 


When using SEL-RESTORE, remember that account dictionaries follow all other 
files for the account. To restore Q-pointers for the SYSTEM Dictionary, use 
the “N” option with File# = 1. This will be the last file on the tape. 


—_—_____—______- Attach tape. 
ATTACHED, RECORD SIZE = 3192 


Bypass coldstart seetion. 


+a ——— Read label to assure proper size. 
DOC.ACCTJ08:01:33 G1 JUL 82 


)~~+—— estore all items into DICT TEMP. 


ACCOUNT NAME ~—~——___—_-_—_— File on tape ts called DICT sTaT- 
FILE NAME? , ~<t—_——— FILE under SYSPROG account. 
SYSTEM 1 
BLOCK-CONVERT 2 
DL/ID (S$) 
DL/ID (S) 
PROCLIB 5 
DL/ID (S$) 
SYSPROG 7 
MD (S) 
M/DICY (S) 
DL/IL ($8) 
STAT-FILE 11 
[992] 33 ITEM(S) HAVE BEEN RESTORED 


Figure A. Example of SEL-RESTORE 
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11.8 TCL Initiation of File-Restores: :FILES and :ABS/FILES Verbs 


A complete formatted file-restore is part of a complete system (“AF”) load. 
One may also be initiated as part of a coldstart (use the “F” option) if it is 


desired to keep the current system software. Finally, a file-restore may be 
initiated trom TCL by using the :FILES or :ABS/FILES verb. 


Complete File7Restore 


To use :FILES (Figure A), mount the first reel of the file-save and perform 
these steps: 


l. Attach the tape with the proper record size. 


Ze is present, enter: 

3. Now 

4. If an ABS section is present, enter: 

3. Now eels the tape is positioned at the files section, type: 


Note that all files (including spooler files) on the current system are 
overwritten, the spooler is restarted, and all lines are sent to logon. 


The verb :ABS/FILES functions similarly to the :FILES verb, but may be used to 
restore poth the ABS and files portions of a system. To use this verb, put the 
first reel of the save tape on the drive and perform these steps: 


ly Attach the tape with the proper record size. 


Ze If a bootstrap is present, enter: 


3. Now 
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+ eh tape inet, a biock: Lengin 
[1021] UNIT(#1L) ATTACHED, RECORD SIZE = 2048 of 2048 bytes for the ABS and 
FILES sections te anttcipated. 


[94] END oF tig To bypass bootstrap sectton. 


SSS Reads bape lapel. 
LABEL DOUC.ACCTj0U8:01:04 11 APR 1982 


TAPE SIZE CHANGED TO 08192 eee 
Label indicates record size of 


8192 bytes. 


SPOOLEK STARTED 
SYSTEM 3136,11,1 
BLUCK-CONVERT 3147,7,1 
DL/£D) 3147,7,1 (S) 
CHANNEL 3154,1,1 
be/iD- 3155" 751 
DL/IbD 3130,11,1 (8S) 
PROCLIB 3162,7,1 
DL/ID 3102,7,1. (5) 
POINTER-FILE 3169,5,1 
DL/ID 3169,5,1 (S$) 
SYSPROG 3174,69,1 
MD 3174,09,1 (S) 
m/DICT 3174,69,1 (s) 
DL/Iv 3174,69,1 (S$) 
STaT-FILE 3243,1,1 
DL/ID 3244,87,1 
DISC-ERXORS 3331,3,1 
OL/ LD 3334,.1,. 1 
ERRMSG 3335,17,1 
DL/ LD: 33355171 (5) 
ACC 3154,1,1 (S) 


LOGON PLEASE: Note: All Lines go to Logon. 


Figure A. Example of :FILES Verb from TCL Using Formatted File-Save Tape 
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11.9 Initializing the System: SYSTEM-SETUP PROC 


After you complete a full restore, system upgrade, ABS load, coldstart or 


warmstart, initialize the system with the SYSTEM-SETUP PROC. 


SYS TEM-SETUP 
Execute the SYSTEM-SETUP PROC after a restore, coldstart, or warmstart to reset 
disc error counts, start disc error recording, initialize system locks, reset 


the time and date, and to perform other functions associated with setup. 


Figure A presents a sample dialogue resulting from the use of this PROC. 
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THIS PROC IS USED TO INITIALIZE CERTAIN SYSTEM 
PARAMETERS DEPENDING ON WHAT TYPE OF 

LOAD WAS JUST PERFORMED: 

l. (AF) FULL RESTORE OR SYSTEM UPGRADE 

2. (A) ABS LOAD 

3. (A) COLDSTART 

4. (W) WARMS'TART 

ENTER OPTLON NUMBER: 


ALLOCATE PERMANENT LOGON WORKSPACE 


HOW MANY PAGES ARE TO BE EJECTED ON THE STANDARD QUEUE (U,1,2,3,4,5)? 


bO YOU WANT MEMORY ERROR RECURDING? (Y,N) 

NOW RESETTING DISK ERROR COUNT 

NOW STARTING DISK ERROR RECORDING 

NOW RESETTING MEMORY ERROR COUNT 

NOW STARTING MEMORY ERKROK RECORDING 

NOW CLEARING THE ACCOUNTING FILE OF ACTIVE USERS 

THE CURKENT SYSTEM TIME AND DATE IS 10:32:26 31 JAN 1983 
BO YOU WISH TO CHANGE THE TIME OR DATE (Y/N)? 


YOU ARE WOW BEING LOGGED OFF 


Figure A. Sample Dialogue Using SYSTEM-SETUP PROC 
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11.10 Formatted File-saves and FILE~SAVE PROC 


File-saves should be performed on a daily basis to protect the data base. 


Formatted file-save tapes are also a means of transporting software and data to 
other machines. 


A formatted (logical) file~save dumps files in hierarchical order. Because 
each item is treated individually, file-save tapes may be used for selective 
restores. It also allows statistics to be ypathered by the save. This approach 
allows users on the system while the save is running, though updates to files 
or file groups already saved will not be saved on the tape. 


FILETSAVE PROC 
‘The general form of tue input line is: 
FILE-SAVE {(T)} 


The FILE-SAVE PROU counts the number of hold files and prompts for the tape 
record size (a carriage return produces a default of 8192 bytes). The record 
size must be a multiple of 5l2. Any reply that does not satisfy this 
requirement is rounded up to the next 512 multiple. The process then attaches 
the magnetic tape unit, rewinds the tape, writes an EOF mark, and then rewinds 
the tape. Next a tape checkout program is executed and the tape is rewound. 
The next prompt is: 


VAPE LABEL IF DESIRED= 


Any string up to 16 characters may be included in the tape label. A tape label 
is always written on the tape preceding the ABS section. It contains the time 
and date, and reel number, and the tape block record size. If the “T°” option 
is used, the tape label is not written. 


The tile-save may now proceed. A coldstart section, an ABS section, and files 
section are dumped. Upon completion, a T-DUMP of the STAT-FILE is appended. 
This T-DUMP could later be loaded into the STAT-FILE and _ the PROC 
“LIST-FILE-STATS” could be executed to show the contents of that tape. After 
the T-DUMP, the PROC “LIST-FLLE-STATS” is entered to produce a file statistics 
report. 


Figure A illustrates a file-save process. 
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Default ts 8192 bytes. 


09:33: 1983 

THERE ARE 2 HOLD FLLES 

TAPE REUORD BLOCK LENGTH (IF OTHER THAN 8192)? 
[92] TAPE ATTACHED, RECORD SIZE = 8192 

[94] END OF FLLE 


START PASSi ~~ WRITE THEN READ 20 RECORDS OF X755AA55AA7 
START PASS2 -- WRITE THEN READ 20 RECORDS OF X’OOFOOFFO’ 
TAPE READ AND WRITE COMPLETE WITH NO ERRORS 


of 


~<«— Up to 16 eharacters 
tape tdentificatton. 


TAPE LABEL IF DESIRED 


+++ START FILE SAVE ... 09:34:02 O07 APR 1983 


77 ITEMS SELECTED. 
[94] END OF FILE 


40 [TEMS SELECTED. 
(94] END OF FILLE 


33 ITEMS SELECTED. 
ENTER FILE NAME FORMATTEK 

NOW MAKING FRAME LIST AND LABEL FOR --->FORMATTER 
[94] END OF FILE 


Al@~1215 —q———_____________ ss Indicates ABS area dumped. 
SYSTEM —————————_____________ Listing of system files. 


[99] 699 TAPE RECORDS WRITTEN 
.+» END OF FILE SAVE ... 09:53:57 O7 APR 1983 
T-DUMP STAT=FILE 


130 ITEMS DUMPED 
[94] END OF FILE 
NOW PREPARING FILE-STATISIICS REPORT 


FiLb SAVE COMPLETE... 


Figure A. Starting a Formatted File-Save 
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11.11 File-Save Tapes: Format 


A formatted file-save tape has many types of data. The format of a file~-save 


tape is discussed below. 


A formatted file-save tape created by the FILE-SAVE PROC contains the 
following: 


The coldstart section consisting of several 5l2-byte frames of system modes 
in a binary-copy format 


An end-of-file tape mark 
A tape label 


An ABS section consisting of a series of tape segments formatted as 
follows: 


_A*£f£EE*.. «(512 bytes binary)...*cece 
where: a segment mark 
fffft 4 digit hex ASCII frame number 
om attribute mark 


eccc 4 digit hex ASCII checkcode = sum of the 512 bytes 


A final section consisting of an “X° followed by enough blanks to complete 
the last tape record 


An end-of-file tape mark 

A file section containing various segments each separated by a segment mark 

An end-of-file tape mark 

A T-DUMP of the STAT-FILE 

An end-of-file tape mark 
Several types of segments are in the files section (Figure A). The first byte 
of each is a segment mark. This was designed so that restores would not be 
stopped if some error destroyed tape segment(s). Segments are referred to by 


the second character or “segment type". Currently, there are D, Q, B, I, O and 
X segments. The following topic describes these segments in more detail. 
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33-1109 


ABS SECTION SEGMENTS 


A ~<———_________.__. Hepresents one frame of object code. 
K <I ndicates end of ABS section. 


FILES SECTION SEGMENTS 


b ~———-_____-——__—_ Represents a new file. 


Q <—____--____—_ A D-potinter with a base equal that of previously 
saved sile. 


3 <e———_________—. 4 DATA/BASIC cataloged program. 
gt AN LEO 

Q <—-____. Save list or DATA/BASIC object code. 
A oae End of Files Seetion. 


Figure A. Formatted File-Save Segment Types 
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11.12 Tape Segments in Formatted File-Save 


Files section sezment types D, Q, I and B are described below. 


b-segments identify a new file. Their format is: 
(SM)D(AM) level( AM) filecount(AM)size...pointer...(AM) 


where “level” is 0, 1, 2, or 3, and equals one plus the level of the dictionary 
in which the D-pointer is placed. There is only one level zero D-segment, 
which identifies the SYSTEM Dictionary. This segment is derived from the item 
“SYSTEM” in the SYSTEM Dictionary. A level one D-segment defines a pointer to 
an account Master Dictionary, a level two D-segment defines a file dictionary, 
and a level three D-segment defines a pointer to a data file. “Filecount" is a 
sequential file number in hex assigned to D-segments. The “size" field and the 
rest of the pointer item is saved as it is in the dictionary. 


A Q-segment is generated whenever a UD-pointer is found with a base which is 
already in the table of dumped files. Its format is: 


(SM)Q (AM) level(AM)size....pointer...(AM) 
where "level" is as defined above. 
I-segments are generated one per item dumped. Their format is: 
(St) l£ilecount (AM) group(AM)size....item...(AM) 
The "filecount"” (HEX) is identical to the filecount of the D-pointer which 
points to the file in which the item is found; “group” is the hex FID of the 
first frame of the group from which the item was dumped. This is saved to 
eliminate hashing, and to ensure that the scheme of the “fast method" of 
restoring files can proceed by sequential groups. 
Items in the POINTER-FILE are saved as B-segments of the following form: 
(AM)size...item...(AM) 
In addition, each frame (the first of which is pointed to by a POINTER-FILE 
item containing the cataloged object or SAVE-LIST) is saved with a segment of 
the form: 
(SM)OB(AM)filecount(AM)1000 bytes of frame in ASCII hexadecimal format (AM) 
Each binary byte in the cataloged frame is converted to two ASCII hexadecimal 


bytes in the tape segment. ‘Typical formatted tape segments are shown in Figure 
A. 
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KECORD = 5 ; 512 BYTES. 


UUU: 
O50: 
LOU: 
150: 
200: 
250: 
300: 
350: 
4Uu; 
450: 
500; 


RECURD = 6 ; 512 BYTES. 


O0U: 
O50: 
100: 
150: 
200: 
250; 
300; 
350: 
400: 
450: 
500: 
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MB“ A™6**°"**"R*5°5* 16°5519*OU1LC5*S*5*BEGIN*5*77** 
RTS t 6 Dol 9 UUL92"S* 24st 2" AT TEr551 970 
OLBRESULT“A*2*******1L,"2°1* 16°5519°001B87S*8*VERS* 
BTL 7271 *_Q*2*0022DL/TD*D*18546°47714**47L72071 
TBO e 9002 oT EMP *D" 206267 1***°"L 710744 (1.1 )* p23 
“A*0027DL/LD*D*2U6277171°****L*10777(1,1)* Dt2*B70 
O29NEWAC™D°21767°117177***L*1U***(11,1)* Qp3*0020D 
L/LD*D*21787711°1*°****L*107_IBf551B70014SP-EJECT“P 
“L0A8*_1B*551B"0015BLOCK~PRINT*P*41~ [B*551B*OU1IM 
ULD*PM*4UAU"_IB7551B*U0LE*A99987A*9998777774*7R~47] 
* FB" 55 1B"00 


Lb7*8°7°V/CONV****"*L*1571* _IB*551B*0OUBAND*C1* IB 
“551 B*UUUFHEADING*CL* ILB*551B*U0018T-WEOF*PZ76033°B 
U23*_IB*551B°0U1BV/MIN*A*117******L73*1* 1B*551B70 
O17FORM~LIST*P*2*3U3A*_IB*551B*0U1B*A1L0*A*107*777* 
“L*LU*1*_1B*551B*0U19*A8*A*8*******L°1071* IB7551B 
“OULOUSER*P*4UBB* IB*551B*OO1LF117S*1L1*V/MIN*1177*77 
“L*3*1*_1B°551B*0U1L6T-LOAD*PT*35°207C* IB*551B*0UU 
CDICT*CY* [87551B7U002F BLOCK~CONVERT*Q*BLOCK=CONVER 
T°****°°L*1071* [B*551B*0ULSSP-ASSIGN*P*1LOA7* B75 
51B*0U22LP132°PQ*(DICT PROCLIB LPL32)* _1B*551B*001 
7DATE-FORMAT 


(Segment marks (X'FF') print ae ' ' here). 


Item SP-EJECT (stze: 20) in group X'551B' 
tn the lith file. 


@-segment (level 8: data file) defines DL/ID 
whtsh has same base, modulo and separation 
as file NEWAC. 


D-segment (level 2: dictionary file) defines 
NEWAC ftle as the 11th file. 


Block of I-segments, each defining an item in 
the NEWAC file. 


Figure A. Typical Formatted Tape Segments 
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11.13 Operation of Formatted File-Save 


This topic describes the operation of the formatted file-save process. 


The file-save dumps all pointers and all subfiles at each level before dumping 
the data for that level. This is done so that D-pointers can be placed at the 
front of their group when the file is restored; e-g., for a simple system, the 
order might be: 


SYSTEM POINTER 


ACCOUNTL POINTER 
FILE-DICTIONARY1 POINTER 

* DATAL POINTER 

* DATAL ITEMS 

* DICTIONARY] ITEMS 
FILE-DICTIONARY2 POINTER 
DATAZ POINTER 

* DATA2 ITEMS 

DICTIONARY2 ITEMS 

* ACCOUNT1 ITEMS 


* 


ACCOUNT2 POINTER 


SYSTEM DICTIONARY ITEMS 
* Blocks of I-segments 
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DUMPED LAST——te SYSTEM DICT DUMPED AFTER 
ALL SUBSIDIARY 
FILES 
DUMPED 35TH— ACCOUNTL ACCOUNT2 


FILE-DICTLONARY 1 FILE-DICTIONARY2 


i 


‘ 


DUMPED 2ND DUMPED 4TH 
DATAL DATA2 
DUMPED 15ST DUMPED 3RD 


Figure A. Typical Layout of Formatted File-Save Process 
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11.14 Binary Save/Restore: Overview 


The Binary Save/Restore (BS/R) utility performs a binary dump of the dise to 
magnetic tape, providing a fast method of data backup. It is loaded into 


memory from tape, replacing the normal SEQUEL monitor. The BS/R utility is not 
intended to totally replace the formatted file-save utility. 


The Binary Save/Kestore utility performs a disc-to-tape transfer, duplicating 
the disc byte for byte onto tape. Therefore, the BS/R tape should only be used 
to restore systems with the same disc and terminal configuration as the source 
system. Individual files and items cannot be restored with the BS/R process. 
Conditions such as Group Format Errors are not detected by this utility. In 
addition, since individual bytes are transferred, the integrity of the data is 
related to the integrity of the tape media itself. For these reasons, the 
Binary Save/Restore should not be used to totally replace the formatted 
file-save utility. The BS/R utility may be used for daily backups, while using 
the formatted file-save for weekly or monthly backup operations. 


Saves 


The Save portion of the Binary Save/Restore program transfers the data stored 
on each disc into memory, one track at a time, and writes each track of data to 
tape as one tape record. Disc space is left untouched during the saving 
process and is rewritten during the restore process. After either process, a 
SEQUEL system is brought to life by a system coldstart. 


The BS/R program modules are included in the item “COLD-LIST" which is 
standardly used to generate a "“COLDSTART" section on tape (refer to the section 
titled COLDDUMP AND SAVE VERBS). Tne "“CULDSTART" section is written at the 
beginning of a binary-save tape as well as file-save tapes. The boot procedure 
using the binary-save tape displays the message "OPTIONS(X,B,D) = ". The "B"” 
option places the 8S/R program in memory and proceeds to question your 
intention of saving or restoring binary disc data. The binary data is saved 
immediately after the "COLDSTART" section on tape, separated by an end~of-file 
mark (EOF). Thus, after a save or a restore, the first reel of a binary-save 
tape way be used to coldstart (“X” option) a SEQUEL system. 


As the binary-save operation proceeds, the process automatically assigns the 
most efficient record size according to the type of disc unit(s) on the system. 
During the process of transferring disc content to tape, progress is displayed 
-in terms of tape record number, current disc being saved, and disc sector 
number. 
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You have the option of verifying the tape generated by the save. Tf this 
option is chosen, each reel is verified prior to the mounting of the next reel 
(for multi-reel saves). This verification checks the ability to read the 
written tape, validates the sequential integrity, and compares the tape data to 
that reread from the disc. 


RESTORES 


When a system is restored from a BS/R tape, the utility first reads and 
displays the tape label to ensure the correct tape has been mounted. The 
process then reads a subsequent record which has preserved the disc 
configuration table of the source system. If the disc configuration of the 
object system is not the same as the source system, the process displays an 
error message and aborts. Otherwise, tape records are written to disc as would 
be compatible with the source system. 


After each record is written to disc, the system verifies that the disc frames 
written may be read correctly. tne system automatically rereads the disc 
frames written and compares the data with that read from the tape; however, if 
the restore is performed at 1U0 ips, no reread is done. 


Figure A lists both the features and considerations of the Binary Save/Restore 
utility. 


FEATURES 
Copies the disc(s) byte for byte to tape. 
Provides for faster system backup than the formatted file-save. 


Provides for data verification both during the disc-to-tape transfer 
and the tape-to-disc transfer. 


CUNSIDEKATIONS: 


All users must be logged off during save and restore process. 


May be restored only onto systems with like disc and terminal 
configurations. 


Does not totally replace the formatted file-save. 


Figure A. Features and Considerations of the Binary Save/Restore Utility 
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11.15 Binary Save/Restore: Tape Format 


The Binary Save/Kestore tape format is different than that resulting from a 
formatted file-save. The BS/R tape consists of two sections: a coldstart and 
a disc data section which includes a label (consisting of a reel identifier, 


the source system’s disc configuration table, the last saved sector on each 
disc, a user”s comment, time and date), and actual disc data. The two sections 
are delimited by an End-Of-File (EOF) mark. 


The coldstart section consists of numerous program modules (512 byte records) 
which are called upon to establish the controlling program (i.e., monitor and 
8S/R) requested in response to the coldstart “OPTIONS” message. 


At the end of the binary save, the tape generated contains the following: 
A coldstart section as mentioned above. 
An End-Of-File (HOF) mark. 
A tape label consisting of 16 bytes of user information followed by the 
time, date, reel number, and information concerning the system’s disc 
configuration. During a restore, the systems disc configuration is 
compared with that recorded here. lf they are different, the restore is 
halted. 
An Inter-Record Gap (LkG). 


The system data in binary format. 


An End-of-File (EOF) mark at the end of each reel and after the last data 
record of the last reel. 


In the case of multi-reel saves, the subsequent reels consist of a tape label 


which identifies the reel sequence followed by the system data in binary 
format. 
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Colddump bS/R Monitor Binary 
(SEQUEL Monitor) Program Dise Data 


Used to restart Used to load 

the system after BS/R utility 

a Save or Restore. before a Save 
or Restore. 


Tape Label } system data 
(binary) 


Used to determine Includes the ABS 

if the system to be frames (system software) 
restored has the same embedded throughout 

disc configuration. This section. 


Inter=Kecord~Gap 


= End-Of-File mark 


Figure A. Binary Save/Restore Tape Format 
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11.16 Binary Save/Restore: Disc Save (Part 1) 


The Binary Save/Restore program modules must be loaded into memory from tape. 
As a stand-alone process, these 8S/R modules may be first dumped to tape using 
the BINARY-SAVE PKOC, and then loaded into memory by “bootstrapping” the system 
via the System Control Menu. This process overwrites the SEQUEL 
memory-resident monitor and loads the BS/R modules in its place. 


To create a Binary Save Tape, you must: 1) make sure all users are logged off, 
2) execute the SHUTUVOWN PROC to “flush” residual updates to the disc (this PROC 
is described in Uhapter 11), 3) load a scratch tape on the tape drive, and 4) 
log to SYSPROG from Terminal Zero. 


The format of the BINARY-SAVE PROC is: 
: BINARY-SAVE 


Once you enter “BINARY-SAVE", the system CULDDUMPs a SEQUEL bootstrap section 
(MONITOR) to the tape which includes the BS/R monitor program. You are then 
asked the question: 


START NEXT TAPE(Y/N) 
? 


Enter “Y° if you wish to colddump a bootstrap section on another tape; enter 
“N° to return control to TCL. 


To load the program into memory from the BINARY-SAVE tape, turn the key switch 
to TEST, enter <c>D to display the System Control Menu, and enter Option Two 
(BOOTLOAD). When the "OPTIONS" message appears on Terminal Zero, enter “B”. 
At this point the configurator display appears as for an “AF” restore. 
Following this display, the message: 


DO YOU REQUIRE A SAVE OR RESTORE?(S/R) 


appears. To perform a disc-to-tape transfer, enter “S“. The system returns 
with the prompt: 


ENTER TAPE DRIVES TO BE USED WITH DRIVE x. <CR> IF NONE. 


Tnis prompt will be used for future enhancements. For this release, simply 
press the <RETUKN> key. Tne next prompt you see is: 


SKIP UNUSED CYLINDERS? (Y/N) 


Enter “Y* to skip cylinders associated with entries in the system’s overflow 
table; enter “N” to save every cylinder on all discs. 


The next screen display is a report of the system’s disc status. Each disc is 
individually started, tested and reported on. As each is tested, the message 
"TESTING DISC Dx" is displayed. If a disc fails the test, the system displays 
an error message and aborts the program. When a disc passes the test, “OK” is 
displayed and the program continues. 
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As soon as all discs pass the testing phase, the system displays the message: 
STOP ON DISC ERRORS? (Y/N): 


A “Y° stops the program when a disc error is found, allowing you to then decide 
what to do (see the section BINARY SAVE/RESTORE: ERROR RECOVERY). An “N* 
response allows the program to continue without your intervention; however, 
each error is logged and reported at the end of the save. 


= —___—___. Dumps a coldetart seation and 
plO2ZL} UNITC#L) ATTACHED, RECORD SIZE = 8192 the BS/R program to tape. 
[94] END OF FILE 


COLDDUMP COLDSTAKT 


77 ITEMS SELECTED. 
[94] END OF FILE 
4U ITKMS SELECTED. 
[94] END UF FLLE 


33 ITEMS SELECTLD. 

ENTEK FILE NAME FORMATTER 

NOW MAKING FRAME LIST & LABEL FOR --->FORMATTER 
(94) END OF FLLE 

BINARY-SAVE TAPE GENERATED. 

START NEXT TAPE(Y/N) 

; 


a es te bringe up the System 
Control Menu; you then enter 
Option 4. 


OPTIONS (4,b,D) 

16 IS THE SPOOLER“S LINE 

INITIALLZE SPOOLER TABLES? (Y/N) 

ENTER NUMBEK OF TIPH LINES 

2048k OF MEMORY 

DRIVE DU, REFLEX-IL 

DRIVE bl, REFLEX-LL 

DRIVE D2, KEFLEX-II 

CONFIGURAILON CORRECT? (Y/N): 

DO YOU REQUIKE A SAVE OR RESTORE (S/R): 
ENTER TAPE DRIVES TO BE USED WITH DRIVE 1. <CR> IF NONE. 
SKIP UNUSED CYLINDERS? (Y/N) 


TESTING DISK DO 
OK 
TESTING DISK DL 
OK 
TESTING DISK D2 
OK 


STOP ON DISC ERKOKS? (Y/N) 


Figure A. Sample Dialogue of a Disc~to-Tape Transfer 
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11.17 Binary Save/Restore: Disc Save (Part 2) 


The screen that follows the "STOP ON DISC ERRORS? (Y/N):" prompt asks you’ the 
foliowing four questions: 


1) VERIFY TAPES BY RE-READING: NO 


“NO” is the default answer specifying no validation. Changing the response to 
“YES” causes the system to read the saved data and compare it to that on disc. 


2) REEL 1 CONTAINS BOOTSTRAP FILE: YES 


Again, the default value is provided. A “NO” response commands the program to 
write on the beginning of the cue mounted tape. Therefore, if you select 
this option, immediately mount a blan tape before the program is overwritten 
with data. 


3) COMMENT FOR TAPE LABEL 
Here you may enter a 30-cnaracter label. 
4) DATE FOR TAPE LABEL 
Enter whatever date you want to appear on the tape label. 


At the bottom of the screen is the instruction on how to change a default entry 
or enter a label: 


TO ENTER OR CHANGE DATA, ENTER PARAMETER NUMBER 
TO PROCEED WITH SAVE, ENTER CARRIAGE RETURN: 


For example, if you wanted to verify each save tape, enter the parameter “l". 
You would then be prompted for the proper information (i-e., a response of 
"YES"). After responding to any of the above prone an updated menu is 
repainted on the screen. If you did not wish to change a default value and/or 
enter a label, you would press <RETURN> to begin the transfer of data from disc 
to tape. As soon as the <RETURN> key is pressed, the screen is erased and, in 
the upper right-hand corner of the screen, a continually updating display of 
the save’s progression appears in this format: 


RECORD # DRIVE if SECTOR # 
errrrrrr dd SSSSSSSSs 


where “rrrrrrrr” represents the current tape sequence number; dd“ represents 
the disc being saved; and “ssssssss” specifies the starting sector address of 
the track being saved. 


When each reel is completed and rewound, these messages are displayed: 


RECORD xxxxxxxx TERMINATES REEL 

DISMOUNT REEL x 

MOUNT KEEL y ON DRIVE z 

TYPE “C” WHEN TAPE READY 
The last two messages prompt you to mount the next tape and enter “C”; these 
prompts only appear when performing a wmultiple-ree Save. If the save 
concludes and you did not choose the verify option, the program terminates. If 
ou did select the verify option, the reel is rewound to BOT and the verify is 
eyun. As the verity proceeds, the sector number is updated. 


When the entire save process is completed, the following messages appear: 
DISMOUNT REEL z 
SAVE COMPLETE 
NO ERRORS 
Coens REQUIRED TO RESTART SYSTEM. 


To perform a coldstart, mount reel one on the tape unit and enter <c>D at the 
">" prompt. 
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SEQUEL BINARY SAVE/RESTORE 


“SAVE OPTIONS- 


DISKS WHICH WILL BE SAVED 


VERIFY TAPES BY RE-READING 
REEL 1 CONTAINS BOOTSTRAP FILE 


COMMENT FOR TAPE LABEL 


DATE FOR TAPE LABEL 


ENTER OR CHANGE DATA, ENTER PARAMETER NUMBER 
PROCEED WITH SAVE, ENTER CARRIAGE RETURN: <cr> 


RECORD # DRIVE # SECTOR # 
00000096 BO 00001923 


RECORD 000005C3 TERMINATES REEL 


DISMOUNT REEL 1 
SAVE COMPLETE 


NO ERRORS 
COLDSTART REQUIRED TO RESTART SYSTEM. 
Ee. JO73F OU 
Sr AEN “eed to diantay Syatem 
Control Menu; select Option 2 
(BOOTLOAD). When the 
"OPTIONS" message  appeare, 
enter 'X', 


Figure A. Sample Dialogue of a Disc-to-Tape Transfer 
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11.18 binary Save/Restore: Restore 


The Binary Save/Restore modules are loaded into memory from the BS/R tape by 
"pooting” the system via the System Control Menu. A system may be restored 
from the BS/R tape(s) provided that its disc and terminal configuration is 
identical to the source system. ‘fhe data is transferred byte for byte from the 
tape to the dise unit(s), the disc maps will appear to be the same. It is not 
intended that the Binary Save be used to transfer data from one system to 
another (the formatted file-save should be used for this purpose). 


To restore a system ae: the S/R tape(s), mount Reel #1 on the tape unit. 
Boot the system as described in the topic BINARY SAVE/RESTORE: DISC SAVE (PART 
1). To the message: 


DO YOU KEQUIRE A SAVE OR A RESTORE?(S/R) 
enter “R”. 
To the prompt: 
ENTER TAPE DRIVES TO BE USED WITH DRIVE n. <CR> IF NONE. 
press the <RETURN>D key. 
The system then displays these messayes: 


MOUNT REEL 1 ON DRIVE L 
WHEN TAPE READY ENTER "C" 


After you mount the first reel of the BS/R save and enter “C”, the label 
information from the tape is displayed on the upper half of the screen. 


This display is followed by the message: 


RESTORE PASS 
REQUIRED Disk DRIVES ARE Dy Dz... 


The “Dy~ and “Dz” represent the dise drives saved on the tape; these drives 
must also be present on the system being restored. If the identical 
configuration is not present, the restore is aborted. Should an abort occur, 
you may either mount another BS/R save tape, or perform a coldstart to reload 
the SEQUEL monitor (provided the system was already running). If no abort 
occurs, the dise drives are then tested; the results of the testing are seen 
as: 


TESTING DISK Dx 
OK 


After all discs are tested, you are asked: 
STOP ON DISK ERRORS? (Y/N) 


Enter “Y~ to stop the program and display the disc errors; enter “N” to 
continue the restore without interruption. After answering the above question, 
there is a five-second pause; at this point, the screen is erased. In the 
upper right-hand corner of the screen is a continual update of the restore’s 
progress. 


The restore transfers data from tape to disc until the current reel is 
exhausted or the discs are completely restored. Errors which may occur during 
the restore are detailed in the section BINARY SAVE/RESTORE: TAPE ERROR 
RECOVERY DURING KESTORE. 


When the current reel finishes, the reel is rewound and an end-of-reel report 
is displayed: 


TAPE INPUT, NO ERRORS 
DATA TO DISK; NO ERRORS 
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These messages are cisplayed when there are no errors detected. Had there been 
errors, the “NO ERRORS" statement(s) would be replaced with the number of 
unrecoverable tape and disc errors. 


Following this report, you are then instructed to mount the next reel (if you 
have a multiple-reel restore). The system reads the label of the newly mounted 
reel to ensure that the correct reel is mounted. If you mounted the wrong 
reel, you are notified by these messages: 


REEL NUMBER OUT OF SEQUENCE 
MOUNT KEEL n 


When the restore program concludes, an end-of-reel report is displayed, 
followed by: 


RESTORE COMPLETE 


Following "KESTORE COMPLETE" is an end-of-program report. This report is 
identical to the end-of-reel report except that accumulative totals of all 
reels are displayed. This concludes the Restore program. You may restart the 
system by performing a coldstart from either a BS/R bootstrap, or a sys-gen or 
file-save bootstrap. 


DO YOU REQUIRE A SAVE OR A RESTORE?(S/R): 
ENTER TAPE DRIVES TO BE USED WITH DRIVE 1. <CR> IF NONE. 


MOUNT REEL 1 ON DRIVE L 
WHEN TAPE READY ENTER “C 


COMMENT: 
TIME/DATE: 
RESTORE PASS 
REQUIRED DISK DRIVES ARE: DO Dl D2 


TESTING DISK DO 

OK 
TESTING DISK Dl 

OK 
TESTING DISK D2 

OK 

STOP ON DISC ERRORS? (Y/N) 


RECORD # DRIVE# SECTOR # 
00000096 DO 00001923 


TAPE INPUT: NO ERRORS 
DATA TO DISK: NO ERRORS 
RESTORE COMPLETE 


TAPE INPUT: NO ERRORS 

DATA TO DISK: NO ERRORS 

COLDSTART REQUIRED TO RESTART SYSTEM. 
E 0073F OU 


Figure A. Sample Dialogue of a Tape-to-VDisc Transfer 
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11.19 Binary Save/Restore: Tape Error Recovery During Save 


Generally, BS/R tape errors fall in two categories: recoverable (soft) and 
unrecoverable. All soft errors are reported to Terminal Zero at the end of 


each reel and at the end of the program. Depending upon the circumstances, 
some soft errors are reported at the time of their occurrance. Unrecoverable 
tape errors are reported to you as soon as they are detected. 


To assist in BS/R tape error recovery, the system now writes a “sequence 
number" in the first four bytes of every tape record. As records are written 
to tape, this sequence number is incremented by one, beginning with the first 
record written on the first reel and ending with the last record written on the 
last reel. Should the system detect a discrepancy in sequence number order, 
the error is first logged and automatic error recovery is attempted. Should 
the recovery attempt fail, you may be given recovery options (system 
permitting). 


Listed below are the different types of write errors that may occur while 
performing a binary save, how they are reported, and the options you have to 


overcome these errors. 


Write Errors 


When awrite error is sensed, a WRITE-RETRY procedure is activated. This 
procedure moves the tape back several records, reads forward to synchronize the 
sequence numbers and repositions the tape at the beginning of the faulty 
record. The program then attempts to write that record again. If this 
procedure is successful, the save continues; if unsuccessful, the retry is 
repeated several times. When all retries fail, the message: 


TAPE WRITE ERROR, RECORD n, DRIVE o 
TYPE K(RETRY), T(TOPOFF), OR X(ABORT) 


is displayed. Enter “T°” to write an end-of-file (EOF) marker after the last 


“good” record, report end-of-reel status, and prompt for another tape. Enter 
“R” to rewrite the errant record. Enter “X° to terminate the save program. 
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Verification Errors 


When the optional verify portion of the save program encounters an error, the 
message: 


THIS REEL DOES NOT VERIFY 
ANY KEY WILL CONTINUE WITH NEXT REEL 


is displayed. The tape is then rewound and you are asked to mount the next 
Save reel. Once you mount the next reel and press a key, the Save continues. 


End-of-Save Status Report 


When a Save is completed, the following information is displayed on Terminal 
Zero: 


i) Last record number saved on reel 
2) Number of dise errors 
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11.20 Binary Save/Restore: Tape Error Recovery During Kestore 


Described below are the different types of tape errors that may occur during a 


binary restore, how they are reported and the options you have for recovery. 


Soft Read Errors 


This error occurs when the tape hardware detects a problem and is able to 
correct it. Such errors are reported to you at the end of each reel and at the 
end of the Restore program. 


bMA Overrun on Read 

Should this error occur, a READ-RETRY routine is executed. This routine moves 
the tape back several records, reads forward to synchronize the sequence 
numbers, and repositions the tape at the beginning of the faulty record. The 
program then attempts to read the errant record again. If the retry is 
successful, the error is logged for subsequent reporting; if unsuccessful, the 
error is logged as unrecoverable and the following information is displayed: 


1) Tape sequence number at the beginning of the reel 
2) This information about the current record, the two previous records and, 
if available, the next two records: 
a) Tape sequence number 
b) Number of bytes in the tape record 
c) Whether the error was caused by a hardware problem 
3) Status of the tape drive 


You are then prompted for a decision: 
TYPE K(RETRY), A(ACCEPT), OR K(SKIP) 


where “R” executes the READ-KETRY routine; “K~ skips the error and continues 
with the next program step; “A” accepts the error, the error is logged in the 
end-of-program routine as an unrecoverable error, and the Restore continues 
where it left off. 


Sequence Errors 
When the Restore program encounters an unrecoverable sequence error, the 
following information is displayed: 


1) Tape sequence number at the beginning of the reel 
2) The following information about the current record, the two previous 
records and, if available, the next two records: 
a) Tape sequence number 
b) Number of bytes in the record 
c) Whether the error was caused by a hardware problem 
3) Status of the tape drive 
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pad of Reel uetatue Se epOre 
The following messages are reported to Terminal Zero when a reel is completed: 


1) Number of unrecovered tape errors 
2) Number of hard disc errors 


End-of—Program Status Report 


The following messages are reported to Terminal Zero when the last reel of the 
Restore is completed: 


1) End-of-reel status for final reel (see above) 

2) Total number of unrecovered tape errors on all reels 
3) Total number of hard disc errors 

4) An end-of-program message 


83-1109 283 


ll SYSTEM MAINTENANCE PROCEDURES: SYSPROG ACCOUNT 


11.21 Binary Save/Restore: Disc Error Recovery 


Wnen a disc error is detected, the Save or Restore program finds out if the 
error is recoverable. If the error is not recoverable, it is considered a hard 
disc error; if recoverable, the command executed at the time of the error is 


re-executed several times. As soon as the error is recovered, the error 
information is stored in the end-of-reel and end-of-program routine. 


When a disc error is detected, the message: 


DISC ERROR 

SECTOR # nnnnnn 

Disc STATUS mmmmm 

STOP UN DISC ERRORS? (¥/N) 


is displayed. &nter “Y° to abort the program, enter “N“ to accept the bad 
data and continue with the program. 
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THIS PAGE INTENTIONALLY LEFT BLANK. 
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11.22 Planned Shutdown Program 


This program allows you to perform a secure and complete halt of the system 
(i-e., no data will be altered in a manner that cannot be accurately recovered 


when power is restored). You must have a SYS(2) privilege level to execute 
this PROC. 


It is suggested that you use this program when you: 
1) boot the system 
2) perform a binary save or restore 


3) change the system hardware 
4) leave the office for the evening or weekend. 


The following text includes a description of the prompts initiated by the 
program, responses expected from and options available to you, and an 


explanation of the system®s status report. 


NOTE: Before you run the Shutdown program, you must make sure that all active 
users are logged off. 


Shutdown Prograin 
To execute the Shutdown program, enter the following command: 
SHUTDOWN <cr> 
Once "SHUTDOWN" is entered, you are asked: 
DO YOU WANT TO MESSAGE ALL USERS OF THE PENDING SHUTDOWN? 


Enter “N°” if you do not wish to send the message; entering “Y~ causes this 
question to be displayed: 


“HOW MANY MINUTES WARNING SHOULD BE GIVEN?~ 


Here you may enter a number from 1 to 5. Once a number is entered, the message 
"THE SYSTEM WLLL SHUTDOWN IN x MINUTES. PLEASE LOGOFF." is repeated each 
minute along with the number of minutes remaining. Following these messages is 
a System Status Report. 
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System Status Report 


The initial task of the Shutdown program is to evaluate the state of the 
system. By scanning through all configured PCBs, the system finds those users 
still logged on. Then, for each user logged on, their PIB and PCB is checked 
for type of process (i.e., phantom, spooler, or normal) and its status. This 
data is then used to generate the following status report covering all active 
processes: 


PIB ACCOUNT 
PORT STATUS ACTIVITY NAME LOCATION 
tt status NORMAL name NO 
TIPH OK 
SPOOLER 


Following this report are the following messages: 


WARNING! THE SHUTDOWN SHOULD NOT PROCEED IF USERS ARE LOGGED ON, 
OR IF THE SPOOLER IS ACTIVE! 


DO YOU WANT TO PROCEED WITH THE SHUTDOWN? (ENTER “Y”~ OR “N”). 


Enter “N” to terminate the program and return to TCL; enter “Y” to begin the 
Shutdown. As soon as the Shutdown is completed, these messages are displayed: 


SYSTEM SHUTDOWN 
TYPE “R" TO RESUME 
> 


At this point, the system is in a secure state, and power to the system may be 
turned off. To an active terminal, the system now appears to have stopped; no 
one can log on to the system. 


There are three methods you can use to restart the system: 1) enter “R® in 


response to the terminal prompt, 2) perform a warmstart or, 3) perform a 
coldstart. 


You may enter “KR” or perform a warmstart if the system”s memory devices were 
maintained after the Shutdown (i.e., a MOS system had battery backup). This 
procedure is especially useful if all active useres were not logged off. 
Either of these two methods should reactivate each process, thus appearing as 
if a Shutdown had never occurred. 


You must perform a coldstart if: 1) memory boards were changed, 2) battery 
backup was not provided (for a system with MOS memory), or 3) a Binary-Save was 
performed after the Shutdown. 
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11.23 COLDDUMP and SAVE Verbs 


The COLDDUMP verb creates a coldstart section on tape from items in the 


SYSTEM-OBJECT file. The SAVE verb allows you to dump ABS frames and files. 


The COLDDUMP verb creates a series of binary data 512=byte tape records 
necessary to perform a bootstrap on any system. An item called COLD-LIST in 
the SYSTEM-OBJECT file contains the list of item-ids necessary for the 
coldstart. The FORM-LIST verb is used to select these items (see Figure A). 
Modes included in the monitor and boot loader are not located in the ABS area. 
The monitor is always resident in main memory. The general form of the 
COLDDUMP verb is: 


COLDDUMP file-name {item-list} {(E)} 
The 'E't option causes error messages to be printed. 


The SAVE verb initiates dumping of the ABS and/or the files sections. It also 
generates file statistics. The general form of the SAVE verb is: 


SAVE SYSTEM * {(options)} 

where "options" are; 

A Dumps ABS frames. ABS limits will be prompted for. Enter a <er> to 
dump all ABS sp specified by the hardware, otherwise enter decimal 
numbers or ranges separated by commas. For example; 1-10,15,20-500. 


D Dumps data files. 


F Lists the name of every file as it is encountered. Otherwise, only 
account names are listed. 


a Saves individual account. 
K Kills output to tape. This option is used to generate statistics 
only. 


s Creates file statistics in STAT-=FILE. 

T Inhibits writing tape label. 

Z Used instead of the 'S' option to create file statistics. When the 
'Z' option is used, a final prompt is made for the name of the file 


in which the statistics will be recorded. 


Note that the 'S', 'Z', 'I', and 'F' options are meaningful only if the 'D! 
option is also specified. 
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Any prompts displayed (a prompt is indicated by a "?") will be in the 
following order: 


1. An optional description to be included in the tape label, The 
description may be up to 16 characters, 


2. ABS limits. See 'A' option above. 


3. The name of the file in which the file Statistics will be recorded if 
the 'Z' option is used. 


Group Locks 


The file=save locks each group before accessing data in the group, to prevent 
data loss due to "soft" group format errors, Up to four groups may be locked 
at one time; one in the SYSTEM Dictionary, one in the account Master 
Dictionary, one in a file dictionary, and one in a data file, 


Tre e Fo s 


If the file-save encounters a group format error, the secondary space is 
copied into new frames in overflow, the frames previously in the secondary 
space are disconnected, and the new frames are connected to the group. This 
is done to alleviate conflict between files that are using common frames for 
their secondary space, 


Non-Saved Items- Skeleton Files 


An item in a dictionary whose D/CODE is 'DX! will not be saved. A file 
pointer whose D/CODE is 'DY' will be saved, but items in the file will not be 
Saved, such as the data portion of the STAT-FILE, which is not valid after a 
restore, 


Use of Overflow 


If the 'S! or 'Z' option is not used, the file-save can be run when there is 
no available dise space on the system. No additional space is needed unless 
the total number of files on the system exceeds 1500. One frame of overflow 
is needed for every 125 files on the system in excess of 1500, 


‘ASSIGN =TAPE 2 
[1021] DEVICE(S) TAPE 2 NOW ASSIGNED , 
RECORD SIZE = 8190 


:FORM-LIST SYSTEM-OBJECT COLD-LIST <er> Gets item-ids for items necessary 
xx ITEMS SELECTED, for coldstart. 


>COLDDUMP SYSTEM-OBJECT (E) <er>d Creates coldstart tape suppressing 
messages except érrors. 


Figure A. Creating a Coldstart Tape 
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11.24 Creating and Enabling User-Accounts 


The CREATE-ACCOUNT PROC creates new user-accounts. The SETUP-ASSY PROC enables 
the user~account to assemble SEQUEL assembly language programs. All accounts 
are set up to run DATA/BASIC. Both of these PROC“s are present in the SYSPROG 


account. 


The CREATE-ACCOUNT PROC performs the following: 


. Creates a new file (to be the user’s M/DICT) with the new user-name as 
the file definition item-id; the file definition item is placed in 
the SYSTEM Dictionary 
Copies the contents of the NEWAC file (the prototype M/DICT) to the 
newly created user M/DICT 

. Adds a file synonym definition item in the SYSPROG account equated to 
the new M/DICT (to allow access from SYSPROG) 


The CREATE-ACCOUNT PROC is evoked by typing in the PROC name: 


CREATE-ACCUUNT 


Tnis PROC then prompts you for the required information which is summarized in 
Figure A. A null input (i.e., carriage return only) for any of the prompts 
(except ACCOUNT NAME, PRIVILEGES, and MODULO, SEPARATION) generates a null 
value for that attribute in the user identification item (see Chapter 6). A 
null input is not allowed for ACCOUNT NAME. A null input for "PRIVILEGES" 
generates a SYSO level and zero additional work space. The modulo and 
separation default values are 29 and 1, respectively. 


After all prompts have been answered, the system further prompts: 
ENTER NUMBER TO CHANGE, * TO CANCEL, RETURN TO CONTINUE: 


A carriage return in reply to the above prompt causes the PROC to create the 
new account. A number causes the corresponding entry-screen prompt to be 
reopened. An asterisk cancels the PROC. Once a carriage return is entered, 
the PROC should not be interrupted with the <BREAK> key. 


_The CREATE-ACCOUNT PROC should not be used to create a new synonym to an 
existent account; this should be done by using the EDITOR to create the file 
synonym definition item in the System Dictionary. 


SETUP=ASSY PROC 
The SETUP-ASSY PROC sets up a user-account so that it is able to assemble 


assembly language programs. To evoke this PROC, enter “SETUP-ASSY" followed by 
the account name. For example: 
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ACCOUNT 


Once activated, the PROC asks a series of questions requiring input from you. 
These questions are self-explanatory. However, it should be noted that a 


response of 


"Y¥" to the prompt: 


ENTER “Y* TO CREATE CSYM AND XSYM FILLES FOR THE ACCOUNT (Y/N)? 


causes file “XSYM to be temporarily created on the SYSPKOG account. 


PROMPTS 


ACCOUNT NAME <———————_—_—_________ 


L/RET-CODE(S ) << —_____ 


L/UPD-CODE(S ) <————$$—$$$$______________. 


PASSWORD ——————_______—__________. 


PRIVILEGES 


ACCOUNT FI 


MODULO, SEP 
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ADDITIONAL WORK SPACK «<— 


LE UPDATE Y/N <————___—_-_____ 


ARATION <——————_____________. 


Figure A. Information Required 


EXPLANATION 


The new account name may be up to 
50 characters tong and contain any 
characters except commas. 


This ts the set of retrteval Lock 
codes to be assoectated with the 
user; multtple values ean be 
entered separated by value marks 
(<e> J, X'FD'). (The retrteval 
lock eodes are deseribed in the 
chapter LOGON/LOGOFF.) 


This is the set of update Lock 
codes assoctated wtth the user 
(same as retrieval Lock codes 
above). 


This ts the password assoetated 
with the user's LOGON item in the 
SYSTEM Diettionary. 


This tis the code deseribing the 
user's privileges and work space 
asstgnment (deseritbed in the 
chapter LOGON/LOGOFF). 


If 'Y' te entered, a 'U' te placed 
in the 9th attribute and Logon 
history data will be aceumilated in 
the ACCOUNT file. 


This is modulo and separation fon 
the M/DICT. Default value for 
modulo ts 29; default value for 
separation te 1. 


by CREATE-ACCOUNT PROC 


291 


ll SYSTEM MAINTENANCE PROCEDURES: SYSPROG ACCOUNT 


11.25 Deleting User-Accounts: DELETE-ACCOUNT PROC 


Tne DELETE-ACCOUNT PROC deletes all files belonging to a specified account, 


thus removing the account from the system. 


DELETE-ACCOUNT is a PROC in SYSPROG-PL which prompts for the name of an account 
to delete. The dialogue is shown in Figure A. 


After the account name is verified, the PRUC displays all duplicate D/CODE 
pointers and y-pointers to D/CODE pointers that point to the account. You are 
then given the option of cancelling the deletion or continuing with it. If you 
continue, all duplicate D/CODE and Q-pointers are deleted from the system. 


DELETE-ACCOUNT also checks for users logged on to the master, duplicate D/CODE, 
and y-pointer accounts. If any user is logged on, the delete is cancelled. 


This PROC sets the group lock, as does the FILE-SAVE PROC, to prevent the 
account from being deleted during a FILE-SAVE operation. 


Requirements to run DELETE-ACCOUNT are: 


1. All other users should be logged off before running this PROC because 
an item in the System Dictionary will be deleted. 


2. You must be logged on to SYSPKOG. 
3. DELETE-ACCOUNT uses the item-ids “ZDAaccount—names~ and 
“4DAaccount-name4%" in SYSPROG’s M/DICT; if the process is interrupted 


and terminated before completion for any reason, DELETE THESE ITEMS 
FROM SYSPRUG“S M/DICT! 
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HICROVATA DELETE-ACCOUNT ft! IF A FILE-SAVE IS SAVING THE ACCOUNT TO BE It! 
!!! DELETED, THEN DELETE-ACCOUNT WILL WAIT UNTIL !!! 
{!! THe ACCOUNT IS SAVED. . 2. 6. ee a ee ew 2 


ENTHR ACCOUNT NAME? | 
LS “DUMMY” THE RIGHT : wi ? 
CHECKING FOR GROUP LOCKS ON FLLE-SAVE 


NOW PREPARING LLST OF FILES “9 DELETE 
NOW DELETING ACCOUNT LEVEL FLLES 

RAAK LYUMMY“S DL/ID DELETED 

RARE DUMMY S M/DLOT DELETED 

RAK YUMMY°S MD DELETED 

AeA YUMMY7S PROC DELETED 


KARR DELE'UKE ACCOUNT “DUMMY” COMPLETED 


TT 


Figure A. Sample DELETE-ACCOUNT Dialogue 


63-1109 293 


1l SYSTEM MAINTENANCE PROCEDURES: SYSPROG ACCOUNT 


11.26 System Generation and Verification 


This topic discusses SYSPROG PROCs that relate to the system generation 
process. For further information regarding these PROC’s, refer to _ the 


installation procedures supplied with the applicable software release. 


The SYS-GEN PROC creates a SYS-GEN tape from which either an initial system 
load or a system update may be performed. The SYS-GEN tape consists of a 
coldstart section, an ABS section, a files section, and TI-DUMPs of system 
files. The system places two EUF marks after the last tape file. Because the 
SYS-GEN PkUC changes with each release of the system, it is not described here 
in detail. 


The SYS-UPDATE PROC updates system files after a new release of software is 
loaded. Because its use and operation are peculiar to each release of the 
system, detailed instructions are not given here. 


The UPDATE-ACCOUNT PROC updates accounts after a SYS-UPDATE to reflect changes 
to verbs, PROCs, and other elements of a M/DICT. It should never be used to 
update the SYSPROG account, which is always done separately as part of the 
system update procedure. Because the use and operation of this PROC is 
peculiar to each release of the system, detailed instructions are not given 
here. 


SER TES ote ee 


The VERIFY-SYSTEM PROC verifies the object code in the SYSTEM-OBJECT file 
against the corresponding code loaded in the executable ABS region and lists 
modes that have mismatches. 


If no options are specified, the MVERIFY “E° option (list only errors) is 
assumed. Other options for the MVERIFY verb may be specified, such as, ~P” 
(output to printer) and “A” (list all mismatch bytes). The MVERIFY verb is 
described in the SEQUEL Assembly Language Programming Manual. 


This PROC should be executed whenever there is a suspicion that the system 
software is not operating correctly (e.g., abnormal aborts, etc.). If 
mismatches occur, the code loaded in the ABS area is bad and the corresponding 
item from the SYSTEM-OBJECT file should be MLOADed. If a checksum error 
occurs, then most likely the item in the SYSTEM-OBJECT file has changed (or was 
patched incorrectly). In this case, it is best to T-LOAD the item from a 
SYS-GEN tape, apply applicable patches, and then MLOAD the item. 
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11.27 On-line Testing of Main Memory: MEM-DIAG Verb 


The HEM-DIAG (Memory Diagnostic) verb on the SYSPROG account allows on-line 


testing of main memory and of data transfers to and from disc. 


The MEM-DIAG operation may run concurrently with other processes. The 
diagnostic requires a block of contiguous frames which must be present 
(otherwise, the diagnostic ends without printing a message). The diagnostic 
runs by writing (and reading) data into (and from) these frames one at a time. 
The memory block each frame is read into is tested by propagating (via an MIIT 
instruction) the patterns of X°FF“, X700%, X°55°, and X“AA%. Each is then 
verified with an SCD instruction. This is repeated the number of times 
specified in the loop count parameter (x). As different frames are accessed, 
different main memory buffers are used. Note that the incidence of checking 
different buffers is random because different buffers are available at 
different times. Also, only buffers which are virtual (i.e., not memory locked 
and not used by the monitor) are checked. 


Running this diagnostic not only checks main memory, but also checks data 
transfers to and from disc. On the second and subsequent loops through the 
contiguous block of frames (selected large enough to flush memory) the data 
pattern is checked in each frame as it was written to and read from the disc. 
An incrementing pattern of X°00° through X“FF” is used for this test. 


The diagnostic puts items in the specified error file to tell the operator what 
it found. The diagnostic runs as long as these items fit in the primary space 
of the error file. To limit the diagnostic in the event of many errors, the 
diagnostic quits as soon as a secondary frame is needed. 


The data portion of the error file should be cleared prior to execution of 
MEM-DIAG. The diagnostic must be terminated by pressing the <BREAK> key and 
typing "END". 


The general form of the MEM-DIAG verb is illustrated in Figure A. The errors 
recorded in the specified file have the general format shown in Figure B. Hard 
errors are recorded only 10 times. 


Errors found while testing a memory resident frame are given a code of "M" 
indicating memory failure. Errors found while checking a frame that has 
previously been written with the incrementing pattern are given code "C” 
_indicating a transfer error. No attempt is made to determine a read versus 
write error. 


The incidence of buffers tested by the diagnostic is recorded in PCB+28. Each 
of the first 128 bytes in this frame is a count of times the memory test was 
run in the corresponding buffer starting with buffer 0. The next: 128 bytes 
contain counts of times the DMA check was run. After the counts reach 255, 


they are reset to 0. The only way to display these counts is with the 
debugger. 
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MEM-DIAG file-name {(x,yyyy-zzzz,c)} 


where: file-name is the file which will be used to store errors 


x is the loop count for the memory portion of the test; 
default is 3 


is the lowest memory address to be tested (in hex); 
default = X°00007 


is the highest memory address to be tested (in hex); 
default = limit of current configuration (maximum = 
X°7FEEEFF) 


is the size of the block of frames to be used. The 
default is 20U unless "yyyy" and "“zzzz" are specified, 
in which case the default is: 


Figure A. General Form of MEM-DIAG Verb 


Item-id: date*time 


code M-memory failure, C-dise read/write failures 
error addr Memory location of first bad data byte 
correct-byte What the data should have been 

error-byte Actual data read from memory 


FIv Frame identification under test 


count Number of errors in one frame 


Figure b&b. General Form of Errors Recorded in Specified File 
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11.28 Disc-Error Recording 


The system records disc errors for use by customer engineers. 


When enabled, the system records disc errors as they occur. Up to 36 errors 
can be recorded, after which the oldest errors are overwritten. All types of 
disc errors except DMA channel overruns are recorded. 


when a disc error occurs, an ampersand (&) is printed on the terminal that 
caused the disc operation. The rest of the system will not hang up on the one 
disc error. 


The data recorded includes: FID, major and minor status, action code, time and 
date, error count, device address, unit number, and cylinder and sector. 


bise error recording is started automatically by an “X”, “A”, or “AF” restore. 
The disc error table remains in its current state after an “X” restore. 
However, after an “A~ or “AF” restore, the table contains the disc errors 
recorded from the tape used to execute the restore. Therefore, the 
SYSTEM-SETUP PROC should be executed after an “A” or “AF” restore to initialize 
the disc error table. This table is not reinitialized by a warmstart (option 
“W7); however, disc error recording is stopped. The SYSTEM-SETUP PROC should 
be used following a warmstart to begin error recording. 


To stop dise error recording, execute the DE-STOP verb. To record the errors 
in a file, execute the DE-COPY verb. At system generation time a file 
DISC-EKRORS is created for this purpose. 
The general form of the DE-COPY verb is: 

DE-COPY file-name 
The DE-COPY verb creates items in the file specified with item-ids in the form: 


date*time*count 


where “count” makes a unique item-id in case more than one error occurred 
within one time interval. 


The item-body is in the form: 


E*FLID*ma jor-status*minor-status*“action-code 
“count-of-errors*disc-device#*unit#*head#*cylinder*sector 


This torm is compatible with the memory diagnostic and the ATP (Acceptance Test 


Procedure) diagnostics. The DE-COPY verb stops recording and initializes the 
table. ‘To continue recording errors, the DE-START verb must be issued. 
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The PROC LIST-DISC~ERROKS produces a report of the disc errors contained in the 
DISC-ERRORS file, while the PROC RESET-DISC~ERRORS clears the DISC-ERRORS file 
and executes DE-RESET and DE=-START. 


Figure A presents examples of the use of some of these commands. 


13:31:07 02 FEB 1983 


DATE.... TIMK. FID....... MAJ MNR DRV CMND CNT DEV HEAD CYL. SCTR.. 
STS STS STS ADD 


02/02/83 13:32 52878 20 #80 31 80 838 DO 8813 


END OF LIST 


Figure A. Sample Usage of DE-COPY and LIST-DISC-ERRORS Commands 
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11.29 Disc Mapping: DSKAD Verb 


The DSKAD verb computes and displays a disc address for a frame on the current 


system. 


The general form of the DSKAD verb is: 
DSKAD frame-number 


Figure A shows an example of the DSKAD verb. 
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DISK ADDRESS FOR FRAME NO. 1024 


DISK ADDRESS : D2 
HEAD NO. : a 
CYLINDER : 

SECTOR : 


Figure A. Sample Usage of DSKAD Verb 
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11.30 File Statistics Report: LIST-, ALL=, and ACCOUNT-FILE-STATS 


The File Statistics Report is a valuable tool for data base management. This 


report is automatically created by the LIST-FILE-STATS, ALL-FILE-STATS, and 
ACCOUNT~FILE-STATS PROCs. 


The Statistics Report adds data security by providing a list of file base, 
modulo and separation parameters, and by recording the order of files on a 
file=-save tape. 


The report is broken down by account. The following information is printed 
for each file in the account: 


Minimum and maximum item size 
Minimum and maximum number of items in a group 
Breakdown of groups by percent full’ 


A total line is generated for each account, which lists the total: 


Items 

Bytes (characters) 
Frames (includes linked) 
Group format errors 


Figure A shows a portion of a File Statistics Report. 


The LIST-FILE-STATS PROC prints the File Statistics Report using statistics 
generated by the last save, 


The ALL-FILE-STATS PROC prints the File Statistics Report after creating a new 
set of statistics, 


The ACCOUNT-FILE-STATS PROC is similar to ALL-FILE-STATS except that it 
prompts for one account name and generates statistics for that account only. 


Statistics are recorded in a temporary file when the '2! option is used with 
the SAVE verb, or in the STAT-FILE when the 'S' option is used. When a 
temporary file is needed by one of the above PROCs, it is automatically 
created. Statistics are written to the file in use and then the File 
Statistics Report is generated. 


302 (REV 6/84) 83-1109 


11 SYSTEM MAINTENANCE PROCEDURES: SYSPROG ACCOUNT 


06 DEC 1983 ACCOUNT NAME - SYSPROG PAGE i 
PILE... -csseocerscos BASE, MOD, SEP. ORDER. ITEMS. SIZE.....~ MX/GP MN/GP PRAMES... 258 500 756 1008 125% 150% 2008 >2008 GFE 


SCHANGEDt 17093 1 1 256 2 1,095 2 3.0 6 4 0 Q 6 ty 1 
ACHANGEOS*DL/1D 17093 287 
*OBSOLETER 17092 284 2 47s 0 
OBSOLETE *DL/ID 17092 288 
BP 16605 247 255,442 
BP*DL/ID 16605 248 
CSYM 16541 266 32 
CSYM*DL/ID 16542 267 
DISC-ERRORS 14611 261 
DISC-ERRORS*DL/ID 14612 262 
OL/ID 14211 251 
ERRMSG 14240 231 
BRRMSG*DL/ID 14240 232 
JUNK 34001 239 
JUNK*OL/1D 34002 240 
M/DICT 14211 258 
MD 14211 265 
MEMORY-ERRORS 14314 235 284 
MEMORY~ERRORS*DL/ID 14317 236 0 
NEWAC 16376 252 7,086 
NEWAC*DL/ID 16376 253 
OSYM 16357 255 32 
OSY¥M*DL/ID 16398 260 20,169 
PROC 14211 268 
PSYM 14318 237 32 
PSYM*OL/ID 14319 238 12,342 
RELEASE-LETTER 17657 241 $8,533 
RELEASE-LETTER*OL/ID 17657 242 
STAT-PILE 14586 245 $88 
STAT-PILE*OL/ID 14587 246 17,697 
SYSPROG 14211 228 18,860 
SYSPROG<PL 14356 243 110,877 
SYSPROG-PL*OL/ID 14356 244 
SYSTEM-OSJECT 15037 269 307 
SYSTEM-OBJECT*DL/ID 15038 - 270 681,826 
TEMP 45735 263 32 
TEMP*OL/ID 45740 264 1,668 
TSYM 16450 233 32 
TSYM*DL/ID 16450 234 
USER-MODES 45787 
USER-MODES*OL/1D $8626 
XxSYM : 16461 
XSYM*OL/ID 16462 
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Figure A, Sample Printout of the File Statistics Report 
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11.31 File Statistics Report: STAT-FILE Dictionary 


The STAT-FILE file is created as part of a system update. The SYS-GEN tape 


contains the standard dictionary for this file. 


Creation of the STAT-FILE dictionary and data areas is part of a system update. 
STAT-FILE is contained on the System Programmer (SYSPROG) Account. As it is 
normally updated from this account, there is no need for STAT-FILE on any other 
account. 


Dictionary items as on a SYS-GEN tape are shown in Figure A. A more complete 
description of these items is given in the Appendix. 


When a file-save is started, the STAT-FILE data area is cleared and the current 
file statistics information is written into the data area. 


Running the ALL-FILE-STATS PROC also clears the data file and builds the 
current file statistics. 


The STAT-FILE data area will also be empty after a file-restore is done, 
because Attribute 1 of the DL/ID is a "DY". This is desirable as the 
Statistics would no longer be applicable. 

it is helpful to make synonym accounts in the System Dictionary as Q-pointers, 
leaving only the unique and principal accounts as D-pointers. The Statistics 
Report will then summarize accounts using the same unique account names. 


Figure A is a listing of the STAT-FILE dictionary. 


See the Appendix for further descriptions of these dictionary elements. 
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STAT“FILE. D/CODE A/AMC V/CONV........ V/CORR... V/TYPE V/MAX 
ORDER. A 0 R 4 
ACCNAME. A 1 G¥l L 0 
ACCOUNTNAMES 1 G*l L 0 
FILE. A 1 G1*2 L 20 
FILENAME. A 1 G11 L 10 
LEVEL. A 2 R 3 
BASE. A 3 R 5 
HOD. A 4 R 4 
SEP. A 5 R 2 
ITEMS. A 6 MbO, R 5 
SIZE. A vi MDO, R LO 
MAX-LI A 3 MDO, R 6 
MIN-L A y MDO, R 4 
MX/GP A 10 R 3 
MN/GP A il R 3 
FRAMES A 12 MbO, R ) 
25% A 13 R 3 
50% A 14 R 3 
75% A 15 R 3 
L00% A lo R 3 
125% A 17 R 3 
150% A 18 R 3 
200% A 19 R 3 
>200% A 20 R 3 
GFE A 21 R 3 
RUTUTAL A 22 L 3 
RITEMS A 23 L 3 
POINTERR A 24 L 3 
OERR A 25 L 3 
ROMAX A 26 L 3 
ROMIN A 27 L 3 
AVE.SIZE  5§ 99 F;6;73;/ R 7 
SECONDARY. A 30 F3534;%;12 R 8 


Figure A. STAT-FILE Dictionary 
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11.32 Determining Memory Buffer Status: BUFFERS Verb 


The BUFFERS verb may be used to obtain statistics regarding memory buffers. 


To generate a buffer report, enter the BUFFERS verb in the form: 


BUFFERS {(options)} 


fhe status of each memory buffer used as virtual memory is displayed on the 


screen (or on the printer with the “P” option). The status taken is a 
“snapshot” and is self-consistent. The column labeled "LOC" is the location of 
the buffer in the memory. The number of buffers displayed is (k of 


memory)*2-4. Buffers are sorted by buffer number, unless the “S” option is 
used, in which case the listing is sorted by frame. 


The “N” option inhibits paging of output to the terminal. The “P” option 
directs output to the printer. The “T° option produces a memory contents 
report. Information displayed includes the number of buffers occupied by the 
monitor, ABS frames, work space frames, user program data frames, I/0 busy 
buffers, memory locked frames, and write required frames. The “2% option 
prints the status of buffers with a FID of zero (i.e., monitor code). 


FIs which print as X°FFFF10” through X°FFFFLF” are fake FIDs used to reserve 
memory buffers for tape I/0 and vary according to the tape record size 
attached. Fake FIDs which print as X°FFFFFB” through X°FFFFDA” are the PIBs. 


Figure A presents the general form of the BUFFERS verb. Sample usage of 
BUFFERS is illustrated in Figure b. 
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BUFFERS {(options) } 


tnhtbtt paging of terminal output 
output to printer 

sort by frame 

produce memory contents report 
show monttor eode buffers 


Figure A. General Form of BUFFERS Verb 


FID: I/O BUSY MEMLOCK1 MEMLOCK 
FFFFFC 
FEFFEB 
FFFFFA 
FRFFFY 
FFFFES 
FFFFF? 
FFFFF6 


MEMORY CONTENTS: 
3453 MONITOR BUFFERS 
AgbS FRAMES 


WORK SPACE FRAMES 
USER PROGRAM DATA FRAMES 


I/O BUSY FRAMES 
MEMLOCKED BUFFERS 
WRITE REQUIRED BUFFERS 


Figure B. Sample Usage of BUFFERS Verb 
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11.33 SYSPROG Utility Verbs: LOCK-FRAME and UNLOCK-FRAME 


This topic describes two special utility verbs in the SYSPROG account. 


LOCK-FKAME Verb 


The LOCK-FRAME verb locks a frame in main memory. The general form of this 
verb is: 


LOCK-FRAME number 
where "number" is a decimal frame number. ‘The LOCK-FRAME verb responds with 
the absolute hexadecimal word address of the memory buffer in which the frame 
is locked. The frame remains locked in memory until it is released by the 
UNLOCK-FRAME verb. 
UNLOCK“ FRAME Verb 


The UNLOCK-FRAME verb clears the memory locked buffer status of the frame 
indicated. Tne yeneral form of this verb is: 


UNLOCK-FRAME number 
where “number” is a decimal frame number. 


Figure A presents the format of LOCK-FRAME and UNLOCK-FRAME verbs. 
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LOCK-FRAME nuaber~t———~-———_ Core-Locks specified frame 


UNLOCK~FRAME number“ Un Loeks specified frame 


Figure A. General Forms of SYSPROG Utility Verbs 
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11.34 Group Locks and Execution Locks 


The LIST-LOCKS verb displays group locks. The CLEAR-BASIC-LOCKS verb clears 


(resets) all execution locks. The :INIT-SYSTEM verb clears all group locks and 
execution locks. 


LIST-LUCKS, 


The LIST-LOCKS verb lists the beginning FID of each group that is locked along 
with the line number which has the group locked. There are up to 128 group 
locks. Groups become locked by the file-save processor, or with DATA/BASIC 
READU, KEADVU, and MATREADU statements or PROC F-UREAD, and FBU commands, for 
example. Groups become unlocked by write operations into the group or by 
specific commands issued by a process. If an attempt is made to lock a group 
when all 123 locks are being used, the process will wait for a lock to become 
available. 


Figure A présents an example of the LIST-LOCKS command. 


The CLEAR“BASIC-LOCKS verb resets the 64 execution locks (0-63) that may be set 
by DATA/BASIC and PROC. 


The :INIT-SYSTEM unlocks all locked groups and resets all execution locks. 
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~<~———______— Display lines that have groups locked. Show 
FID of first frame tn group. 


09 17319 
15 31712 
O7 15334 


Figure A. Sample Usage of LIST-LOCKS Verb 
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11.35 Verification of Assembly Language Routines from Tape 


A copy of SEQUEL system software may be kept in T-DUMP format on tape for 


periodic system verification. This frees space which would otherwise be needed 
for the SYSTEM-OLJECT file. 


To copy assembly language routines to tape, the following procedure is 
suggested: 


A. Upon receipt of a full system update tape: 


1. Load the assembly language verification file as directed by the 
updating instructions. 


2. Dump (ST-DUMP) SYSTEM-OBJECT by frame. 


3. Copy the modes necessary for coldstart tape sections to a temporary 
file by entering: 


4. Delete the data section of the SYSTEM-OBJECT file. 


5. Recreate the data section of the SYSTEM-OBJECT file with a smaller 
modulo and copy the coldstart modes by entering: 


6. Delete the temporary “4TEMP-S0% file. 

7. Put the tape away and ensure that it will never be overwritten. 
Bb. If the system includes additional assembly language routines: 

1. Dump and then delete from the disc the additional modes. 


2. be sure to indicate the contents of the tape. 
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C. As additional updates are received: 


l. T-LOAD the latest SYSTEM-OBJECT tape (it may be necessary to 
temporarily copy some files to tape to allow enough space). 


Ze Follow the update instructions accompanying the update. 
3. Create a new system tape as outlined in step A above. 
Db. ‘To verify the system: 
l. Mount the tape(s) created above. 
Ze Enter MI-VERIFY. 
To verify a system from a SYS-GEN tape: 


l. Use the SPACK PkOC on SYSPROG to position the tape at the start of the 
SYSTEM-OBJECT file. 


2. Enter MT-VERIFY. Note that if patches are made, mismatches in 
effected modes will occur. 
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1zZ.1 Overview 


A "process" on a SEQUEL system is defined as the session which occurs between 
logging on and logging off. Each process is associated with a line (or port), 
and (normally) each line is associated with a terminal. The Terminal 
Independent Process Handler (TIPH) initiates a process on a port without an 


associated terminal. any terminal output (such as error messages, logon/logoff 
messages, etc.) is placed in a spooler hold file, the hold file number being 
assigned by tne spooler processor. TIPH may be used for those tasks which do 
not require operator responses, such as file-saves, massive updates, etc. 


TIPH provides a kind of foreground/background capability that allows processes 
to run without the need of a terminal. “Resident” programs, such as a task 
scheduler or a transaction logger, may use TIPH. TIPH increases the efficiency 
ot the system by freeing the terminals for their intended purpose, which is 
user interaction. 


4 TIPH process is like any other process, except that it is not associated with 
a terminal. It has its own work space, and has available to it ail of the 
resources of the SEQUEL system, with the exception of terminal input. You 
cannot access the system through a terminal after the line associated with it 
nas been logged on by a TLPH process. 


Although terminal input is not allowed, you may “stack” input in the command 
stream sent to the TIPH processor. This allows programs to be run which 
require operator input, where the input responses are known in advance. The 
processor passes one command string to each input required by the program (this 
is similar to the secondary input butter used by tne PROC processor). 


Onee activated, a TIPH process takes its place in the process schedule queue. 
because interactive processes are given priority, TIPH processes have low 
priority by default. 


because a TIPH process uses its own PCB, work space, etc., its port number must 
be defined on the system, i.e., tie port allocated to the TIPU process must be 
within the configuration of the system. 


Certain lines may be designated as TIPH-only lines by the system hardware. 
These lines way be displayed by entering the WHAT verb from TCL. Normal lines 
(those normally associated with a terminal) may be designated as being 
‘available for use by TIPH by using the PH-ALLOCATE verb. 


Note: Your account must nave at least 27 additional frames of work space 
(specified in tne System Dictionary) to initiate a TIPH process. You may log 
the TLPH port onto an account other than the current user account. In this 


case you must have System 2 (SYS2) privileges. 
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A PH-HISTURY file exists in the System Dictionary, which contains all of the 
information concerning each TIPH process. This information is dynamic as the 
process continues, displaying the status of the TIPH process(es). 

The LOGOFF verb will not deactivate (logoff) a TIPH process. 

TIPH Verbs 


The TIPH verbs and PROCs are summarized in Figure A. The remaining topics in 
this chapter describe each in detail. 


PH-ALLOCATE Alloeates a port to be available for use by TIPH. 


PH=-DELETE Designates an allocated port as no longer being available 
for use by TIPH. 


PH-KILL ' Aborts the designated TIPH process. 


PH-LINES Lists the lines eurrently available on which to activate a 
TIPH process. 


PH-RESUME Reactivates a temporartly halted TIPH process. 


PH-START intttates a TIPH process. 


PH-STATUS Displays the current status of all TIPH processes listed in 
the PH-HISTORY jfile. 


PH-SUSPEND Temporarily halts a TIPH procees. 


Figure A. Summary of TIPH Verbs and PROCs 
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12.2 Port Assignment: PH-ALLOCATE, PH-DELETE, PH-LINES 


Certain ports may be designated as TIPH-only ports by the system hardware. 
These are always allocated to TIPH. Lines which are normally associated with a 
terminal may also be used by TIPH. Before a normal line may be used by a TIPH 


process, it must be listed in a table of available TIPH ports. The PH-ALLOCATE 
verb enters the designated line into the table. The PH-DELETE verb removes it 
from the table. The PH~LINES verb lists the lines available for use by a TIPH 
process. 


PH-ALLOCATE 
The format of the PH~ALLOCATE verb is: 

PH-ALLOCATE {line#} 
where “line#" is the number of the line to be allocated. If this number is not 
entered, it will be prompted for (Figure B). The entered port number must be 
within the range set by the particular system’s hardware configuration (this 
may be displayed by entering the WHAT verb from TCL). The line remains 
allocated until either the PH-DELETE verb is used, or the system undergoes a 
coldstart (“X” option). 


TLIPH-only lines (as designated by the hardware) need not be allocated via the 
PH-ALLOCATE verb. 


Note: A normal line designated for use by TIPH via PH-ALLOCATE may still be 
used as a normal terminal line when a TIPH process is not running on it. 
A TIPH process may not be initiated on a line already logged on or in 
use by another TIPH process. 
PH-DELETE 
The format of the PH-DELETE verb ts: 
PH-DELETE {line#} 
If "line#" is not entered, the system prompts for the line to be deleted from 
the TIPH list. After the line is deleted, the line is no longer available for 
use by TIPH, unless it is reallocated with the PH-ALLOCATE verb. 
PH-LINES 
The format of the PH~LINES verb is: 
PH-LINES 
This verb lists all the lines currently available for use by TIPH. If an 


allocated line is already in use by TIPH (or any other process), it is not 
displayed here. 
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PH-ALLOCATE {line#} 


PH=DELETE {line#} 


PH-LINES 


Figure A. General Form of PH~ALLOCATE, PH-DELETE, and PH-LINES Verbs 


<< Evoke the PH-ALLOCATE verb. 


INPUT LINE TO ALLOCATE ~+— Designate that Line 1 may be used by a 
TIPH process. 


+ Evoke the PH-DELETE verb. 
INPUT LINE TO DELETE? ~t—— Designate Port 22 as no longer being 


available for use by TIPH. 
LINE DELETED FROM PHANTOM SERVICE. 


<~—— Display the lines currently available 
FOR TIPH USE for use by a TIPH process. In thte 


example, Porte 1, 11, and 16 are avail- 
able. 


3 ITEMS LISTED. 


Figure B. Example of Correct Usage of PH-ALLOCATE, PH-DELETE, and PH-LINES Verbs 
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12.3 Initiating a TIPH Process: The PH-START Verb 


A TIPH process is initiated by evoking the PH-START verb from TCL. The TIPH 
process begins by logging on the specified line. After executing all the 


commands in tne command stream, the line is logged off. All terminal output, 
including the logon and logoff messages, is placed in a hold file. The command 
stream may contain any TCL verb except LOGTO. 


The format ot the PH-START verb is: 
PH-5S TART 


The TLPH processor prompts for a task-id, the desired line number, any desired 
options, an account name, an optional password, and the command(s) to be 
executed (Figures A and 8B). 


The task-id is a user-selected alphanumeric character string which identifies 
tne TLPH process in the PH-STATUS display (see the topic DISPLAYING THE TIPH 
PROCESSES: THE PH-STATUS VERB). It is not the item-id of the item in the 
PH-HISTURY file. It may be up to 140 alphanumeric characters; however, only 
the first 10 are displayed. 


The line number must be either a TIPH-only line or have been allocated (via 
PH-ALLOCATE) for use by a TIPH process prior to evoking the PH-START verb. If 
the line cannot be used py TIPH, tne message "NO LINE AVAILABLE" is displayed. 
If another user (or anotner TLPH process) is already logged on to the specified 
jine, the message "LINE ALREADY LOGGED ON" appears. Note that if another TIPH 
process is logged to the line, T1PH will not queue the current user’s TIPH 
process to wait for it to finish (logoff). 


Tne available options are explained in the topic PH-START OPTIONS. 


The account name you enter is the account the TIPH process will logon to 
execute the command stream. The password is that specified in the System 
Dictionary for the particular account. If there is no password, then just 
press <RETUKND. 


The command stream may consist of TCL statements, a PROC name, or inputs 
necessary to perform the desired tasks. Note that the verb LOGTO cannot be 
used. Each command (or input value) is entered one at a time, separated by 
pressing <RETURN>. The verb "OFF" snould be the last entry in the command 
stream. 


If an operation is to be performed requiring operator input (such as a 
DATa/BASIU program which contains INPUT statements), the input value(s) must be 
included in the command stream. Each is entered individually, separated by 
<RETURN>. Note: To decrease the number of commands entered through TIPH, it 
is recommended that you create a PROC prior to using TIPH, and then evoke this 
PROC in the command stream. 
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PH-START 


Figure A. Format of the PH-START Verb 


—————__——_—_—_———_ voke the TIPH processor. 


TASKLD FOR PH TASK? The task-id identifies the TIPH 
process in the PH-HISTORY ftle. 
For thte example, the task-id ts 
'TEST'. 


KiNTER LINE# FORK PH TASK Thts TIPH process will Logon to 
Line 14 to execute the command 
string. If thts line has not been 
allocated to be used by TIPH, or if 
the associated terminal ts already 
in usé, an error message appeare, 
and the process ts aborted. 


ENTER OPTIONS? The opttone are listed in the topic 
PH-START OPTIONS. For thte example 
no opttone are specified (t.e., all 


terminal output goes to a hold 
ftle). 


ACCOUNT FOR PH JOB? - The TIPH process logs on to the INV 
account to execute the command 
string. 


ENTER PASSWORD The INV account's password ts KRIS. 


ENTER COMMAND STREAM <CR TO END>?~#——— This TIPH process performs a SORT 
on the INVENTORY sile. The output 
ts printed to a hold file (separate 
from the hold file containing the 
TIPH logon and logoff messages). 
The TIPH process ends by logging 
off the line. 


TASK TEST STARTED ON LINE 14 FOR 
ACCOUNT LAV 


Figure B. kxample of Correct Usage of TIPH 
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12.4 PH-START Options 


Normally, all terminal output for a TIPH processs is passed to a hold file, so 
that you may print the output when the process is completed. Certain options 


are available to either prevent the creation of the hold file or to print the 
hola file automatically when the TIPH process is complete. You may also hush 
the TIPH processor message which appears on the “master” terminal. 


The tollowing options are available: 


H Hush the message displayed by the PH-START verb when the TIPH process has 
been started. This message is normally displayed on the terminal which 
Started the TIPH process. The option may be useful if the TIPH process 
itself starts another TIPH process, to prevent the message from being 
passed into the hold file. The “kh” option is not shown in the TIPH status 
display (see the topic DISPLAYING THE TIPH PROCESSES: THE PH-STATUS VERB), 
because it pertains to the "master" process, rather than to the TIPH 
process. 


P Print the hold file on the printer after the TIPH process has ended. The 
result is the same as if you had printed the hold file using SP-EDIT (see 
the topic EXAMINING JOBS WAITING TO BE PRINTED in Chapter &). The hold 
file contains all terminal output yenerated by the TIPH process (such as 
the logon and logoff messages, the responses from the system after a 
SELECT, etc.). Note that the hold file is not deleted by tnis option. 


N Do not maintain a hold file for terminal output. This option results in 
all terminal output being "lost". This may be useful when executing update 
programs, file-saves, etc., when the hold file would only contain messages 
not deemed important for a particular application. 


TT bisplay all terminal output on the terminal associated with the line. This 
may be used, for example, to print a report ona hardcopy terminal. If 
there is no associated terminal, or if the process is executing on a 
TIPH-only line, the TIPH process will “hang" until the process is aborted. 
No hold tile is created because the output is to the terminal. 


Because the logon and logoff messages are also sent to the terminal, you 
are cautioned that, if the line is associated with a hardcopy terminal, the 
messages may appear on the same page as the report. 


The options “HN”, “HP”, and “HT” are also available; they have the same effect 
as the “N°, “P“ and “TT” options (respectively), but also cause the PH-START 
message to be hushed. Even though no comma is placed between the “H* and the 
other options, the “H” will not appear in the PH-STATUS display. 
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&3-11L09 


Figure A. 


Hush the PH-START message. 


Print the hold sile on the printer when the 
TIPH process ts complete. 


No logging; no hold stile te created. All 
terminal output ts lost. 


Allows normal terminal output. Assumes a 
terminal ts assoctated wtth the TIPH port. 
No hold sile ts created. 


Hush the PH-START message. In addttton, 
print the hold sile on the printer when the 
TIPH process te complete. 


Hush the PH-START message. In addition, do 
not create a hold sile. ALL terminal output 
ts lost. 


Hush the PH-START message. In addttton, 
allow normal terminal output. No hold stile 
ts created. 


PH-START Verb Options 
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12.5 Halting ana Reactivating a TIPH Process 


A TIPH process may be aborted or temporarily halted using the PH-KILL and the 
PH-SUSPLND verbs, respectively. A temporarily halted process may be 


reactivated using the PH-kKESUME verb. 


The general form of the three verbs is: 
PH-KILL task-id line# 
PH=SUSPEND task-id line# 
PH-RESUME task-id line# 


where “task-iu" is your specified identification of the TIPH process, and 
“Line#" is the line on which the TIPH process is running. An asterisk (*) in 
place of the task~id implies the process running on the specified line. An 
asterisk in place of the line# implies all processes with the specified task 
name. Any of the three verbs followed by a single asterisk implies all TIPH 
processes (the asterisk following PH-RESUME reactivates all temporarily halted 
processes). 


PH-KILL causes the specified process to abort (logoff). Any updating being 
performed will not be undone. If the TIPH process (or processes) is currently 
running on an account other than your own, System 2 privileges are required. 


PH-SUSPEND temporarily nalts a TIPH process. This may be useful if additional 
processing resources are required for another line (i.e., to speed up its 
process). By suspending the TIPH process(es), more time is available for the 
other jobs. System 2 privileges are required if the TIPH process (or 
processes) is executing on an account other than your own. 


Note: Tne TIPH process must already be active (beyond logging on) before the 
PH-SUSPEND verb may be used. Otherwise, it may “hang" the line. You must 
coldstart (“X* option) the System to release the line (see the topic 
COLDSTART). Because the remainder of the system is unaffected, it igs 
recommended that you wait until all other users are logged off of the system to 
avoid inconvenience and possible group format errors. 


PH-RESUME reactivates a TIPH process which had been temporarily halted with the 
PH-SUSPEND verb. system 2 privileges are required, as noted above. Note that 
a TIPH process may be reactivated from any terminal, not just the terminal from 
which it was halted. 
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PH-KILL task-id line# 


PH-SUSPEND task-id line# 


Pi-RESUME task-id line# 


Figure A. General Form of the PH-KILL, PH-SUSPEND, and PH-RESUME Verbs 
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12.6 Displaying the TIPH Processes: The PH-STATUS Verb 


PH-STATUS displays the scatus of a TIPH process as it is recorded in the 


PH-HISTORKY file. 


The general form ot PH~STATUS is: 
PH-STATUS {task-id line#} {(P)} 


where “task-id" is the user-specified name of the TIPH process, and "“line#" is 
the line to which the process was assigned. If an asterisk (*) is entered in 
place of “task-id", then all processes in the PH-HISTORY file which ran on the 
specified line are displayed (see note below). If an asterisk is entered in 
place of the line number, then all processes with the specified name are 
displayed. PH-sTATUS with no task-id or line# specified displays the status of 
all processes in the PH-HISTORY file. The “P“ option specifies printing the 
status on the printer. 


PH-STATUS displays the following information: the task-id, the line number, 
the account to which the TIPH process is logged, the name of the account which 
started the process, the date and time started, the current status of the 
process, the PH-START options (if any), and the number of the hold file which 
contains the terminal output (Figure 8). 


The status of each TIPH process is indicated by displaying an alphabetic status 
code. “A” indicates that the process is still active; “S” indicates that the 
process has been suspended; “T° indicates that the process has terminated 
normally; “X° indicates that the process was aborted by the process itself 
(abnormal abort), “K~ indicates that the process was aborted by tne PH-KILL 
verb. 


“OUfrL” on the PH-STATUS display is the output file, i.e., the spooler hold 
file to which the terminal output has been sent. Note: If the process printed 
sometning to a hold file (using SP-ASSIGN HS), this hold file number is not 
displayed. The aisplayed hold file number contains the output which normally 
would have appeared on the terminal. There is no terminal output file if the 
“N° option was specified with the PH-START verb. 


Note: Items in tne PH-HISTORY file are not automatically deleted. Therefore, 
when displaying ali TIPH processes, many processes may be shown with the 
same line number and name. The data portion of the file should be 
cleared occasionally, using the CLEAR-FILE verb, as shown in Figure C. 
bo not clear tne file while a TIPH process is still active! 
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PH-STATUS {task-id line#} {(P)} 


Figure A. General Form of the PH-STATUS Verb 


TASK-ID... LINE ACCOUNT... STARTER@ACC DATE........ TIME.... STATUS OP OUTFL# 
LGKADE REG ADM 14 JUN 1980 08:05:37 K T 
SYSPRKOG boc 21 JUN 1980 17:30:17 A P 
CHRLS CHRIS O7 JUN 1980 12:05:11 
INV MASTER O05 JUN 1980 17:00:57 


io JS SYS PROG 11 JUN 1980 09:13:45 


where the status code is one of tne following: 


= Active 

puspended 

Normal termination 
= Abort by process 
= abort oy PH-KILL 


- 


Note that the “hh” option is not displayed. 


Figure B. PH-STATUS Display 


Figure C. Example of Clearing the Data Portion of the PH-HISTORY File 
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12.7 TIPH Initialization Messages 


Initializatiou messages are mainly used to indicate errors in the specification 


of a TIPH process. They may appear while using the PH-START verb. 


The following messages exist: 


NO LENE AVALLAbLE ~ If you did not specify a line, this message indicates that 
all the TILPH lines (both TLPH-only and those normally associated with a 
terminal) are in use. If a line was specified, it indicates that the specified 
line was not allocated for use by TIPH (using the PH-ALLOCATE verb). You 
should allocate a line, if necessary, and reenter the PH-START verb. 


PH=PWU) ERROK - The incorrect password was entered for the specified account. 
You should reenter the PH-START verb. 


PH-LD ERROR ~ No user account was specified. You should reenter the PH-START 
verb. 


HISTORY FILLE PROBLEM - No PH-HISTOKY file exists, or the current account does 
uot have a Q-pointer to it. If the tile does not exist, you may create it 
using the CREATH-FILE verb and the ELITOR. The procedure is described in the 
appendix at the back of this manual. If no Q-pointer exists, then you should 
create it using the EDITOR (Figure Bb). 


LINE ALREADY LOGGED ON - The specified line is being used either by an actual 
user or another TIPH process. You may enter the PH-LINES verb to display the 
currently available Lines. 


HISTORY FILB ACCESS ERROR - For some reason, TIPH cannot properly access the 
PH-HISTURY file. 


MASTER PRIVILEGE ERKOK - You attempted to use TIPH on an account other than 
your own, and did not have 5YS2 privileges. If you are able, you should log to 
the SYSPRUG account and increase your privilege level. 


ACC FILE ACCESS EKROR - For some reason TIPH cannot access the ACC file to 
indicate which lines have been logged on. 


[82j YOUR SYSTEM PRIVILEGE LEVEL LS NOT SUFFICLENT FOR THIS STATEMENT - You 
attempted to initiate a TIPH process and your account only had System 0 (SYSO) 
privileges. 


NOT ENOUGH WORKSPACE - You attempted to initiate a TIPH process and your 
account did not have at least 27 additional frames of work space assigned. If 
you are able, you should log to the SYSPROG account and increase the account’s 
work space assignment. 
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NU LINE AVALLABLE <———““»’»€—>_ Hither. as inte. number was not entered, or 
the specified line was not allocated to 
be used by a TIPH process (using 
PH-ALLOCATE) . 


PH-PWD ERROK The entered password was incorrect for 
the spectfted account. 


PH-ID ERROX <g———__»»»_ 1 No user account was specified. 


HISTURY FLLE PROBLEM —<@————_____—-__ Fither the PH-HISTORY file is missing 
from the SYSTEM dictionary, or 4 
Q-pointer to tt does not exist in the 
current account's M/DICT. 


LINE ALREADY LOGGED UN <-——————-_ The specified line is in use by etther 
an actual user or another TIPH process. 


HISTORY FILLE ACCESS EKROK —#———— TIPH cannot access the PH-HISTORY file. 


MAS'TEK PRIVLLEGE ERRUR ————»—s-—“ You attempted to log the TIPH process 
onto an account other than your oun, and 
your account did not have System 2 
(SYS2) prtvtleges. 


AC FLLE ACCESS ERRUK <————»’[—>_-: [IPH cannot access the ACC ftle. 


[82] YOUK SYSTbu PRIVILEGE LEVEL [S—e Your account has only System 
WOT SUFFICLENT FOR THLS STATEMENT privileges. 


NOL ENOUGH WORKSPACL <—————_- Your = aceount does not have at least 27 
additional frames of workspace assigned. 


Fizure A. Initialization Error Messages 


PH-nISTORY ---in user account's M/DICT 
VOL Q 

002 SYSTEM 

003 Pur-HISTORY 

004 

005 


QQ6 
007 
QUS 
U09 L 
O1U 


Figure 8. Q-Pointer to PH-HISTORY File 
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12.8 TIPH Termination Messages 


The TIPH Termination Messages are placed in the hold file along with the other 


terminal output. These messages indicate the reason the process halted. 


The following are the Termination Messages: 


*T* PROCESS STOP - Indicates that the TIPH process has completed normally and 
has logged off the line. 


*TX PROCESS HAS BEEN LOGGED OFF BY PH-KILL - Indicates that the TIPH process 
has been aborted by the PH-KILL verb. 


*T* PROCESS ABORT - Indicates that the TIPH process has aborted due to’ some 
reason related to the process itself (i.e., not caused by TIPH). For example, 
a TIPH process executing a DATA/BASIC program which aborted due to a 
programming error. ‘nis message may be preceded by one of the messages below. 


*2* INPUT ERROR - Indicates that a process prompted for terminal input, and 
there was no TIPH stacked iuput available. This may occur if: 1) a TCL verb 
which requires user input (such as SSELECT, or COPY) was inadvertently used 
without specifying the required subsequent responses in the command string, or 
2) the verb "OFF" was not the last command in the command stream. 


*H* PROCESS IN DEBUGGER - Indicates that the process has trapped to the system 
debugger. The TIPH process will abort with the *T* PROCESS ABORT message. 
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[910] *T* PROCESS STOP ~-————__—_____——__ [IPH process terminated normally. 


[911] *T* PROCESS HAS BEEN LOGGED OFF~#—— {IPH process terminated by PH-KILL. 
BY PH-KILL 


[912] *T* PROCESS ABORT ~#—————————-._ TIPH process aborted due to an 


error by the process being executed 
(such as a DATA/BASIC program). 


[913] *E* INPUT ERROR ~#——--————————_ The IPH process prompted for 


terminal input, and there were no 
responses in the command string. 


[914] *i* PROCESS IN DEBUGGER ~#—————— The TIPH process hae trapped to the 
system debugger. 


Figure A. TIPH Termination Messages 
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ASCII CHARACTER SET 


PRISM PRISM 
EBCDIC ASCIL If IL 
a a Rs Ct ae tt ent) i Meee SC 
0 OO OO NUL None <> 
L Ol OL SOH None <ces>A 
2 02 U2 STX None <cs>B 
3 O03 U3 LTX None <cesrc 
4 O04 37 KOT None <es>b 
5 05 2D BNQ None <ces pk 
9) 06 2E ACK Noue <csoF, <s>6 
7 U7 2F BEL None <cs>G 
3 U8 lo BS None <es>u 
y uy O05 HT None <es>l 
Lu UA 25 LF None <esod, <s>2 
il OB OB VT None <esrk 
12 OG UC KF None <cesoL 
13 Ob Ob CR None <cesoM 
14 Uk UE rol) None <ces>Nn 
15 OF OF Si None <cs>0 
lo 1U LU DLE None <cs>P 
17 ll ll DEL None <es>Q 
18 12 12 bC2 None <cs>R 
19 13 3A bdu3 None <es>s 
20 14 3c C4 None <cesoTt 
21 15 3b WNAK . None <ces>uU, <s>4 
22 lo 32 SYN None <es>Vv 
23 17 26 ETB None <es>W 
24 18 18 CAN None <csoXx 
25 19 19 EM None <esoy 
26 La 3F SUB None <espzZ, <s>8 
27 1B 27 BESU | ESC, <c>[ 
2% 1c lc FS None 
29 LD 1D GS None 
30 1E LE RS None 
31 1lF LF Us None 
3z 20 40 blank space 
33 ZL 5A ! ! ! 
34 22 7E 7 . " 
35 23 78 i# tt it 
30 24 5B 5 $ g 
37 25 oC vA 4’ 4 
38 26 50 & & & 
39 27 7) ‘a “ <Ep” 
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___ Special Use _ 


Delay character 
PRISM home command 


End of text 


Cursor forward on PRISM 
Bell of PRISM 

Backspace on PRISM 

Tab 

Cursor down on PRISM 
Vertical address on PRISM 
Screen erase on PRISM 
Carriage return 


Sort key delimiter 
Horizontal address on 
PRISM blank compression 
character 


Retype entire line; 
enable slave printer 

Dump PRISM screen to slave 
printer (option) 

Disable slave printer 
Cursor back on PRISM 


Cancel line 


Cursor up on PRISM 
EDITOR command delimiter. 
Envokes SCREENPRO 
command-mode 


String delimiter in 
ENGLISH and BASIC 


String delimiter in 
ENGLISH and BASIC 


APPENDIX a. ASCII CHARACTER SET 


PRISM PRISM 
EBCDIC ASCII Il Il 
decimal Hex Equiv. Char. Display Key Special Use 
40 28 Av ( ( ( 
41 29 5D ) ) ) 
42 2A 5¢ x x * 
43 28 AE + + + 
44 2C 6B > 3 » or <are 
45 2D 60 7 - 
46 2E 4B 7 é +, <e>> 
47 2¥ 61 i / /, <e>? 
48 30 FO O 0) O, <ce>) 
49 31 Fl l i 1, <a>! 
50 32 F2 2 2 2 
51 33 F3 3 3 3, <e># 
52 34 F4 4 4 4, <c>s 
53 35 F5 5 5 5, <a>% 
54 36 F6 6 6 6 
55 37 F7 7 7 7, <ce>8 
56 38 F8 8 8 8, <c>* 
57 39 FY Y 9 9, <a>¢ 
58 3A 7A : : : 
59 3B 5E 3 ; 35 <>: 
60 3C 4c < < < 
ol 3D 7E = = =, <c>+ 
62 3E 6E > > > 
63 3F oF ? ? ? 
64 40 7C @ @ @ 
65 41 cl A A <soa 
66 42 C2 B B <s>B 
67 43 C3 C C <s>c 
68 44 C4 D D <s>D 
69 45 C5 E E <S>E 
70 46 Co F F <s>F 
71 47 C7 G G <s>G 
72 48 Cs H H <s>H 
73 49 C9 I L <s>I 
74 4A DL J J <soJ 
75 4B D2 K K <s>K 
76 4c b3 L L <s>L 
77 4p D4 M M <s>M 
78 4E bs N N <s>N 
79 4F D6 0) O <s>0 
80 50 D7 P P <s>P 
38l 51 Bg Q Q <s>Q 
82 52 DY R R <s>R 
83 33 B2 5 S <s>s 
84 54 £3 7 T <s>T 
385 55 E4 U U <s>U 
86 56 E5 Vv V <s>V 
37 57 E6 W W <s>W 
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rote) 
89 
90 
91 
92 
93 


94 


95 

96 

97 

98 

yg 
LUO 
LO1 
102 
103 
104 
LU5 
106 
107 
1Us 
1u9 
110 
lll 
112 
113 
114 
115 
116 
117 
118 
119 
120 
121 
122 
123 
124 
125 
126 
127 
128 
129 
130 
131 
132 
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58 
59 
5A 
5B 
5C 
5D 


BBCDIC 
Becete boek Sais: Chere -Dieptay.: 


E7 
ES 
E9 
80 
EV 
90 


ASCII 


Keon Km 


| 


Bre wo. HOO hOoAna & 


5 


irr NK KM BK Cranr aso 


DEL 


ASCIL CHARACTER SET 


PRISM 


II 


eH NK KEM CHMNARCH OZER OT AUHTODMCOWP el 


None 
None 
None 
None 
None 
None 


PRISM 
Il 
SS 2 ANON 


<s>X 
<s>y 


Z 
[ 
x 
] 


a 


~ 
Q 
n 
Vv 
OQ 


-AN KH MEK CHMR OVS HR EPA OH EOE PCA e 
ie) 
Vv 


ra 

QO 

Vv 
ui 


<a>> 


_____ Special Use 


String search delimiter 
RUNOFF control character 
ENGLISH string search 
delimiter 

ENGLISH string search 
delimiter 

RUNOFF control character 
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133 
134 
135 
136 
137 
138 
139 
140 
141 
142 
143 
144 
145 
146 
147 
148 
149 
150 
151 
152 
153 
154 
155 
156 
157 
158 
159 
160 
161 
lo2 
163 
164 
165 
166 
167 
168 
169 
170 
171 
172 
173 
174 
L75 


EBCDIC 
Becta ty ek aus Chaty Diaplay. 2 Rey 22 


13 
14 
15 


ASCIT CHARACTER SET 


PRISM PRISM 
II Il 
__ Special Use 


None 
None 
None 
None 
None 
None 
None 
None 
None 
None 
None 
None 
None 
None 
None 
None 
None 
None 
None 
None 
None 
None 
None 
None 
None 
None 
None 
None 
None 
None 
None 
None 
None 
None 
None 
None 
None 
None 
None 
None 
None 
None 
None 
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PRISM PRISM 
EBCDIC ASCII Il II 
Decimal Hex Equiv. Char. Display Key Special Use __ sects 
176 BU 57 None 
177 BL 58 None 
178 B2 59 None 
179 B3 62 None 
180 B4 63 None 
18l ie) 64 None 
182 Bo 65 None 
1383 B37 66 None 
184 BS 67 None 
135 Bg 08 None 
186 BA 69 None 
1387 BB 70 None 
188 BC 71 None 
189 BD 72 None 
190 BE 73 None 
191 BF 74 blank None 
192 cO 75 id @ 
193 cl 76 A A 
194 C2 77 B B 
195 u3 78 C Cc 
196 C4 SA 9) D 
197 C5 8B E E 
198 co &C F F 
199 C7 8D G G 
20U C& SE H H 
201 cy oF I I 
202 CA GA J J 
203 CB 9B K K 
204 cc 9C L L 
205 CD 9D M M 
206 CE 9E N N 
207 CK OF 0) ©) 
208 DO AO P P 
209 Di AA Q Q 
210 D2 Au R R 
211 D3 AC 3 S 
212 D4 AD T T 
213 b5 AE U U 
214 D6 AF V i] 
215 b7 BO W W 
216 Dd BL x K 
217 bg B2 Y Y 
218 DA B3 L Z 
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PRISM PRISM 
EBCDIC ASCII Il Il 
Dectwat tek Rai Che i. PSP lay. Key. 4 Special Use 
219 DB B4 H [ 
220 be B5 \ \ 
221 DD 56 | ] 
222 DE B7 = * 
223. DE BB _ 
224 EU B9 @ @ 
225 Bl BA A A 
226 E2 BB B b 
227 E3 BC Cc Cc 
228 K4 BD 8) D 
229 E5 BE E i 
230 E6 BF F F 
231 “7 CA G G 
232 E8& CB H H 
233 Kg CC I I 
234 EA CD J J 
235 EB CE K K 
236 EC CF L L 
237 ED DA M M 
238 EE DB N N 
239 EF DC 6) 0 
240 FO DD P P 
241 Fl DE Q Q 
242 F2 DF R R 
243 F3 El s S 
244 F4 BA T T 
245 F5 EB U U 
246 FO EC V V 
247 F7 BD W W 
248 FS EE Xx Xx 
249 FY EF Y Y 
250 FA FA vA vA System Delimiters: 
257 FB FB [ [ Start Buffer (SB) _ 
252 FC FC \ \ <e>\ Subvalue Mark (SVM) 
253 Fb FD ] ] <c> ] Value Mark (VM) 
254 FE FE 7 3 <c>* Attribute Mark (AM) 
255 FF FF <er_ Segment Mark (SM) 


NOTE: The <SHIFT> key may have to be pressed on some terminals if the desired 
character appears on the top half of a key top. For example, to 
generate an attribute mark (X”FE”) on some terminals, it is necessary to 
press and hold the <SHIFT> key to generate the "*" character, while 
pressing the <CTRL> key to cause the character to be a control 
character. 
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Message 
Number Message 
1 ILLEGAL USE OF DOUBLE-QUOTE IN ITEM-ID 
2 UNEVEN NUMBER OF SINGLE OR DOUBLE QUOTE-SIGNS ('") 
3 VERB? 
4 MODE'mode'CHECKSUM ERROR; FRAME = n MODE = ccec ABD = aaaa 
5 THE WORD 'word' IS ILLEGAL 
6 FILE NAME 'file namet IS ILLEGAL, 
7 A VALUE MUST FOLLOW THE HEADING, FOOTING, TAG OR GRAND=TOTAL 
CONNECTIVE, 
8 A WINDOW SPECIFICATION STRING MUST FOLLOW THE "WINDOW" CONNECTIVE, 
ts) SYSTEM DL/ID MISSING, 
10 FILE NAME MISSING. 
11 FRAME LOCKED AT LOCATION X 'tnnnn! 
12 POWER FAILURES HAVE OCCURRED SINCE COLD-START 
13 DATA LEVEL DESCRIPTOR MISSING 
14 TAPE INPUT ILLEGAL 
15 THE FILE-NAME IS PRECEDED BY AN ILLEGAL CONNECTIVE. 
17 "WITHIN" VALID ONLY IN COUNT/LIST STATEMENTS, 
18 LAST WORD MAY NOT BE CONNECTIVE 
19 VALUE WITHOUT AN ATTRIBUTE NAME IS ILLEGAL, 
20 n MOS MEMORY ERRORS 
21 CONFLICT BETWEEN USER & SYSTEM NAMES 
22 MEMORY CONTENTS: 
n MONITOR BUFFERS 
n ABS FRAMES 
n WORK SPACE FRAMES n USER PROGRAM DATA 
n I/O BUSY FRAMES 
n MEMLOCKED BUFFERS 
n WRITE REQUIRED BUFFERS 
2h THE WORD 'word' CANNOT BE IDENTIFIED 
25 "WITH" MAY NOT IMMEDIATELY PRECEDE A VALUE 
26 ATTRIBUTE VALUES MAY NOT BOTH PRECEDE AND FOLLOW AN ATTRIBUTE 
NAME, 
27 SEQUEL 
n SYSTEM SERIAL NUMBER 
nk OF MEMORY 
n ABS FRAMES 
n PORTS 
n  WORDMATE 
n AVAILABLE DEVICES 
DEVICE UNIT(S) 
28 | NO CONFIGURATION CHIP. 
29 AT LEAST ONE ITEM-ID MUST BE SPECIFIED FOR A ‘“WITHIN"~TYPE 
STATEMENT, 
30 FORMAT ERROR IN M/DICT ENTRY DEFINING VERB. 
32 #*A REQUIRED ITEM-ID IS MISSING. 
33 n SYSTEM PRIVILEGE LEVEL 


n ADDITIONAL FRAMES OF WORK SPACE 
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42 -ILLEGAL MULTIPLE CONNECTIVES EXIST- 
43 ERROR - RECEIVE OR TRANSMIT FUNCTION NOT SPECIFIED 
yy ERROR =~ FORMAT SPECIFICATION INCORRECT 
46 ERROR = INCORRECT DEVICE TYPE 
47 ERROR - RECEIVE ID 'n' SPECIFIED 
48 ID 'n' ENTERED IN TABLE 
49 RECEIVE ENTRY 'nt COMPLETED 
50 OPERATOR REQUESTED ABORT ON TRANSMIT ENTRY fn! 
51 TRANSMIT ENTRY 'n' COMPLETED 
53 ERROR - TRANSMIT ID SPECIFIED 
54 WAIT TIME FOR RECEIVE ENTRY 'nt MATURED - FUNCTION TERMINATED 
55 LOCAL LINE=PRINTER SET OPERABLE 
57 ID 'nt DELETED FROM TABLE 
58 ID 'n' IS NOT IN TABLE 
59 TRANSMIT ENTRY 'N' ABORTED 
60 LOCAL TASK REJECTED - NO LOCAL PRINTER DEFINED 
61 ERROR = INCORRECT OPTION SPECIFICATION 
62 ID ENTRY IN TABLE FILE MISSING 
63 ERROR - INVALID RECEIVE OPERATION SPECIFIED 
64 ONLY ONE ITEM ID IS PERMITTED IN A "WITHIN" TYPE STATEMENT 
65 SEQUEL - DATA SET NOT READY 
67 TOO MANY IDS SPECIFIED - (MAXIMUM OF 10) 
71 AN ILLEGAL CONNECTIVE MODIFIES THE WORD 'word! 
72 THE VALUE tvaluet IS MEANINGLESS, 
74 ABORT ON RECEIVE ENTRY ‘nt = FUNCTION TERMINATED 
75 SEQUEL - 2780PLUS 
DATA SET NOT READY 
76 SEQUEL - 2780PLUS 
79 THE NUMBER OF SEPARATE AND CLAUSE SETS CANNOT EXCEED 9, 
80 A SYSTEM ERROR HAS OCCURRED IN MODE: mode THIS MAY BE DUE TO SORT 
KEY(S) PRECEDING SELECTION CRITERIA. 
81 SECURITY CODE VIOLATION 
82 YOUR SYSTEM PRIVILEGE LEVEL IS NOT SUFFICIENT FOR THIS STATEMENT. 
86 FILE REFERENCE ATTEMPTED ON FILE NOT PREVIOUSLY OPENED 
90 TAPE IS NOT T-DUMP FORMAT 
94 END OF FILE 
96 BOT 
97 END OF TAPE 
98 TAPE BUFFER SIZE OF n EXCEEDED, 
99 TAPE RECORDS WRITTEN. 
100 ASYNC DEVICE DETACHED 
101 ASYNC DEVICE ATTACHED 
111 ITEM 'item-id' IS NOT ON FILE 
112 NO ENTRIES IN TRACE BUFFER 
113 FORMAT ERROR IN TRACE BUFFER 
117 A DELETE STATEMENT MUST CONTAIN EITHER ITEM-IDS OR SELECTION 
CRITERIA 
120 ‘tyalue' NEGATIVE BALACE NOT PERMITTED 
136 'yvalue' DOES NOT MATCH THE G-CORRELATIVE SPECS. 
151 LINE FID PS RETURN STACK 
158 AN ILLEGAL CONNECTIVE OF THE FORM txt MODIFIES 'value! 
163 ATTRIBUTE FOR SORT-KEY MISSING 
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164 A D1 OR De ATTRIBUTE HAS CORRELATIVES THAT ILLEGALLY PRECEDE THE 
D-CORRELATIVE. 

166 ILLEGAL ATTRIBUTE NAME-~ 'name! 

167 NON-NUMERIC AMC 

168 ILLEGAL CHARACTER IN A=-CORRELATIVE. 

169 ILLEGAL A-CORRELATIVE 

170 MISSING LEFT PAREN IN A-CORRELATIVE 

171 MISSING RIGHT PAREN IN A-CORRELATIVE. 

172 MISSING RIGHT BRACKET IN A-CORRELATIVE 

173 MISSING SEMI-COLON IN A-CORRELATIVE 

175 END OF TAPE.... 

180 MESSAGE NOT IN QUEUE 

181 MESSAGE 'nnnnt ENTERED IN QUEUE 

182 DATA LINK CONTROL CHARACTERS DELETED FROM TEXT 

183 END OF QUEUE 

199 INSUFFICIENT WORK SPACE FOR ITEM 'item-id'. 

200 FILE NAME? 

201 'file name' IS NOT A FILE NAME 

202 'item-id' NOT ON FILE, 

203 ITEM NAME? 

204 FILE DEFINITION 'file-name' IS MISSING. 

205 NO STATEMENTS TO BE ASSEMBLED, 

206 ‘item-id! ASSEMBLED, 

207 UNDEFINED SYMBOLS. 

208 ERROR IN ITEM-ID LIST 

209 tPOINTER-FILE' MISSING A 'B' IN THE 13TH ATTR. CONTACT THE SYSTEM 
MANAGER OR PROGRAMMER, 

210 FILE 'file-name' IS ACCESS PROTECTED. 

211 MODE 'item-id't NO ASSEMBLED CODE CAN BE FOUND. 

212 MODE titem~id' HAS MISSING OR ILLEGAL FRAME STATEMENT 

213 MODE titem-id't LOCATION COUNTER ERROR AT LINE NO. n 

214 MODE titem-id'! EXCEEDS MAX, OF 512 BYTES AT LINE NO. n 

215 MODE 'item-id' HEX ERROR AT LINE NO. n 

216 MODE 'item-id' LOADED; FRAME = n SIZE = n CKSUM =n 

217 MODE 'iten-id' VERIFIED; FRAME = n SIZE = n CKSUM =n 

218 MODE 'item-id' FRAME = n HAS n MISMATCHES 

219 ILLEGAL CAMMAND: command 

220 ~EXITED- 

221 ‘item-id' FILED. 

222 titem-id' DELETED, 

223 titem' EXISTS ON FILE 

22u VERIFIED 

225 CATALOGED PROGRAM HAS n MISMATCHES 

226 TAPE FORMAT ERROR 

229 ‘account=name't IS NOT A VALID ACCOUNT NAME. 

230 CARD READER NOT READY 

231 CARD READER MECHANICAL ERROR 

232 CARD READER EBCDIC ERROR 

233 CARD READER HOPPER EMPTY 

234 ITEM SIZE EXCEEDS 32,000 BYTES 

240 A "SELECT" OR "SSELECT® MUST BE USED PRECEDING A "SAVE-LIST" 
STATEMENT! 

244 ‘item-id' CATALOGED; n FRAMES USED. 
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242 
260 
267 
268 


270 
272 


273 


274 
275 
276 


277 
278 
279 
280 
281 
282 


287 
288 


289 


290 
291 
293 


294 


295 
298 
316 


318 © 


330 
331 
332 


SYSTEM ERROR MESSAGES 


‘item-id' DELETED, 
BATCH=STRING LOCK CODE ELEMENT ERROR AT: nn 
PROC XFER TO 'titem-id ' CANNOT BE COMPLETED 
THE DESTINATION OF THE PROC "GO" STATEMENT: statement, CANNOT BE 
FOUND 
FORMAT ERROR IN THE PROC STATEMENT : STATEMENT 
A VALUE EXISTS FOR THE ATTRIBUTE REFERENCED BY THE ELEMENT: 
element 
ERROR IN COLUMN-NUMBER/FIELD-WIDTH OR FORMAT SPECIFICATION AT: 
statement 
UNRECOGNIZABLE BATCH-STRING ELEMENT : element 
Y OR F SUB-ELEMENT ERROR AT BATCH-STRING ELEMENT : element 
D-2 UPDATE WITHOUT D-1 BEING SPECIFIED, AT BATCH-STRING ELEMENT : 
element 
J ELEMENT MISSING AT BATCH-STRING ELEMENT : element 
ERROR IN PROCESSING SECONDARY BATCH-STRING ELEMENT : element 
INCORRECT SCALING FACTOR IN F#* BATCH-STRING ELEMENT : element 
FILE-DEFINITION BATCH ELEMENT ERROR AT : element 
D1 MUST HAVE Y¥11 STORAGE CORRELATIVE... ERROR AT : element 
DATA INPUT LINE TO BATCH AFTER A SELECT MUST CONTAIN AT LEAST ONE 
ITEM-ID SUBSTITUTION CODE (ASTERISK *) 
TIMESLICE FOR LINE n EQUALS m MILLISECONDS 
CURSOR CONTROL IN PROC STATEMENT : statement SPECIFIES COL#/ ROW# 
GREATER THAN TERM SETTING. 

TERMINAL PRINTER 
n 
n 


PAGE WIDTH : 
PAGE DEPTH: 
LINE SKIP: 
LF DELAY: 
FF DELAY: 
BACKSPACE: 
TERMINAL: 
BAUD RATE: 
PCI: 


3 


BS p esses as5 5 


THE RANGE OF THE PARAMETER ‘parameter! IS NOT ACCEPTABLE 
'file name' FILE-DEFINITION IS MISSING, 

TOTAL NUMBER OF CONTIGUOUS FRAMES = n 

NUMBER OF FRAMES IN THE TEMPORARY SPACE BLOCK 
NUMBER OF FRAMES IN THE TEMPORARY SPACE CHAIN 
START OF LINKED OVERFLOW : 

TOTAL NUMBER OF LINKED FRAMES : 

TOTAL NUMBER OF CONTIGUOUS FRAMES : 

OVERFLOW TABLE 

FORMAT ERROR IN SPECIFICATIONS, 

WHICH LINE? 

COUNT TOO HIGH 

ILLEGAL LINE NUMBER, 

THE ACCOUNT FILE IS MISSING. 

THE LINK FROM PRIMARY HS WORKSPACE TO ADDITIONAL WORKSPACE WAS 
INVALID 


"ou 
a 
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333 


334 
335 
336 
337 
338 


339 
340 


341 
350 
398 


399 


401 
402 
403 
404 
405 
406 


407 
408 
410 
411 
412 
413 
414 
415 
416 
417 
418 
419 
420 


421 
422 


423 


SYSTEM ERROR MESSAGES 


THE FORMAT OF THE ADDITIONAL WORK-SPACE PARAMETER: xxxx IS 
ILLEGAL FOR THIS ACCOUNT NAME, 
ADDITIONAL WORK-SPACE HAS NOT BEEN ASSIGNED, 
FRAMES OF ADDITIONAL LOGON WORKSPACE ARE NOT AVAILABLE 
"Logon Proprietary Message" 
###.L0GGED OFF AT time ON date ### 
USER IS NOT LOGGED ON. 
ACCOUNT FILE STATISTICS WERE NOT UPDATED DUE TO EITHER: 

1. INSUFFICIENT WORK-SPACE TO CONTAIN THE ACCOUNT FILE ITEM, 
OR 

2, SYSTEM DICTIONARY CHANGED WHILE YOU WERE LOGGED ON, 


IMPROPER OR UNDEFINED FORMAT FOR DATE CONVERSION 
EEREEREAEEEEEEEEERERREHE ER REERER ERASER ERRERHERERHRREE ERE REE EEE EE 


Hee CONNECT TIME AT hh:mm:ss = n MINUTES ahaa 
ball CPU MS. =n _ DISC READS = n eek 
ball NUMBER OF ACTIVATIONS = n Lala 


ERRKSKAAKEKKKAHEKAEKRAREEAA TELA RRRARAKSAHRKSLAAEEAHHKERERKAGREEEHES 


A VALUE MUST FOLLOW THE CHARGE-TO VERB. 

INDENTATION PAST END OF LINE, 

THE FILE OR DL/ID REQUIRES A (VERTICAL) CORRELATIVE FOR THIS 
statement. 

THE MAXIMUM OF 20 LEVELS FOR A "“WITHIN"-TYPE STATEMENT HAS BEEN 
EXCEEDED. 

NO ITEMS PRESENT 

FILE DEFINITION titem-id' CANNOT BE DELETED OR OVERWRITTEN 

END OF LIST 

n ITEMS SELECTED, 

n ITEMS LISTED, 

ITEM COUNT = n, BYTE COUNT = n, AVG. BYTES/ITEM = n, AVG. 
ITEMS/GROUP = N, STD. DEVIATION = n, AVG. BYTES/GROUP = n 

n ITEMS COUNTED, 

ONE ITEM COUNTED. 

A SYNONYM (Q-TYPE) FILE CANNOT BE SPECIFIED IN THIS STATEMENT. 
'DICT! OR 'DATA' MUST BE SPECIFIED IN A CLEAR-FILE STATEMENT. 
INSUFFICIENT DISK SPACE AVAILABLE 

THE FILE NAME ALREADY EXISTS IN THE MASTER DICTIONARY. 

ILLEGAL OR MISSING MODIFIER USED IN DEFINING THE FILE AREA(S). 
'item-id' EXISTS ON FILE. 

RANGE ERROR IN MODULO OR SEPARATION PARAMETER, 

FILE 'file-name' CREATED; BASE = n, MODULO = n't SEPAR = n 
FILE=DEFINITION ITEM 'item-id' WAS NOT COPIED. 

THE SPECIFIED FILE CANNOT BE CLEARED OR DELETED! 

DICTIONARY FILE SELETION CANNOT BE DONE WITHOUT DELETION OF DATA 
FIRST. 

STATISTICS OF attribute-name: TOTAL = n AVERAGE = n COUNT = n 
BYTE STATISTICS OF attribute-name: 

TOTAL = n AVERAGE = n ITEMS = n CKSUM = n BITS = n 

TOTAL OF attribute-name IS: n 
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42h 


425 
426 
427 
470 


469 
489 
520 
521 
522 
523 
524 
525 
530 
531 
532 
533 
534 
535 
550 
551 
552 
599 
603 
604 
605 


607 
609 
610 


6114 
612 
613 
614 
615 
616 
617 
618 
619 
620 
621 
622 
623 


SYSTEM ERROR MESSAGES 


DISK ADDRESS FOR FRAME NO, 
DEVICE ADDRESS: 

UNIT NO.: 

HEAD NO.: 

CYLINDER: 

SECTOR: 

INVALID FRAME-~ID REQUEST 
DATA FILE ALREADY EXISTS! 
THERE IS NO DATA SECTION FOR THIS FILE. 

YOUR REQUEST FOR FRAMES IS ILLEGAL! ONLY NUMBERS FROM 1 TO 127 ARE 
VALID 

ILLEGAL FORM QUEUE NAME 

OPERATOR INTERVENTION REQUIRED 

NO DATA FOR BLOCK OUTPUT 

TOO MANY CHARACTERS IN WORD TO BLOCK 

BLOCK=CONVERT FILE MISSING OR IMPROPERLY DEFINED 

BLOCK OUTPUT WOULD EXCEED PAGE WIDTH 

INPUT CHARACTER 'x' IS NOT IN BLOCK-CONVERT FILE. 

INPUT CHARACTER 'x' IS IMPROPERLY FORMATTED IN BLOCK-CONVERT FILE 
ALREADY LOGGED ON 

PROCESS ROADBLOCKED 

ILLEGAL USER ID 

LOGON SUCCESSFUL 

LOGOFF SUCCESSFUL 

ILLEGAL LINE NUMBER, 

A REQUIRED NUMERIC PARAMETER IS MISSING OR INVALID 

SPECIFY NUMBER OF LINES TO SKIP 

ITEM titem-id' HAS INVALID FORMAT 

OBJECT CODE IN 'item-id' IS IN INCORRECT FORMAT. 

DEFAULT ASSIGNMENT IS TO QUEUE "STANDARD", 


Sapo sos 


~'x! IS AN UNDEFINED LABEL REFERENCE. 


FORM QUEUE = 

DEVICE TYPE = 

DEVICE NUMBER = 

SPOOLER OPTIONS = 

COPIES = 

UNACCEPTABLE VALUE 

THE PAGE YOU REQUESTED IS NOT AVAILBLE+ 
LINE# 'n' IS ASSIGNED TO THIS QUEUE, FORM QUEUE CANNOT BE 
DELETED! 

TYPE Y (YES) OR N (NO): 

THE DEFAULT FORM QUEUE MAY NOT BE DELETED 
THE FORM QUEUE IS NOT EMPTY 

NOT A PORT PROCESS 

DEVICE TYPE: 

CANNOT MOVE A FORMQ TO ITSELF 

DEVICE DOES NOT EXIST 

N OPTION DISREGARDED 

LINE# -~OR-~ LINE# FORM-QUEUE: 

LPTR ATTACHED! 

CHECK SPOOLER! 

SPOOLER ABORTED, RESTART IS BEING ATTEMPTED, 
ILLEGAL ACTION CODE 
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624 ENTER ACTION CODE / PAGE NUMBER (P#)+ 

625 FORM-QUEUE PAGES: 

626 NO OVERFLOW FRAMES 

627 ENTER ACTION CODE: 

628 PRINT-JOB# OPTIONS: 

629 FORM-QUEUE FORMTYPE: 

630 ‘STOP! IN EFFECT. USE 'RESUMEt! 

631 OLD-NAME NEW-NAME: 

632 PRINT JOB # COPIES: 

633 PRINTFILE #: 

634 FORM-QUEUE: 

635 FORM-QUEUE OR PRINT JOB #: 

636 FORM-QUEUE~-OR==-DEVICE# TYPE: 

637 FROM-FORM-QUEUE TO-FORM~QUEUE: 

638 NEW-FORM-QUEUE PRINT JOB LIST: 

639 PRINT JOB LIST: 

640 FORM-QUEUE DEVICE~TYPE(LPTR,TAPE,PORT,SPOOL) DEVICE#: 

641 THERE ARE n HOLD FILES 

642 EJECT AND SKIP VALID ONLY FOR PRINTERS 

643 THE FORM QUEUE TABLE IS FULL 

644 PRINTING SUSPENDED ON JOB# 'n! 

645 THERE IS NO ACTIVE JOB TO RESTART 

646 HHERHEHKHERERHREREREH TOP OF PAGE SHRRHHRHEERELHEREHERE HESS 

647 THE DEVICE IS ALREADY ASSIGNED AND CANNOT BE CHANGED. 

648 DEVICE TYPE DEVICE#: 

649 NEW-NAME: 

650 FORMTYPE 

651 CANNOT ALIGN = CANNOT ATTACH DEVICE 

652 TOO MANY PAGES! 

653 OPTIONS: 

654 ILLEGAL OUTPUT STRING LENGTH! 

655 NOT ATTACHED! 

656 JOB ALREADY BEING EDITED BY LINE # 'n! 

657 FILE NOT CLOSED 

658 AN INSTANT PRINT JOB WITHOUT AN H OPTION CANNOT BE EDITED 

659 MUST SUSPEND PRINTING TO EDIT THIS JOB 

660 INSUFFICIENT PRIVILEGES OR DEVICE ATTACHED TO SPOOLER 

661 TAPEOUT TERMINATED BECAUSE OF ASSIGN TAPE, 

662 PRINT JOBS 
PAGE OF PAGES 
PRINT DATE 
QUEUE NAME JOB ACCOUNT LINE CREATED STATUS OPT SIZE 
COPIES 

663 1. MOVE FROM GUEUE 5, DELETE JOB 9. SUSPEND PRINTING 
2. MOVE PRINT JOB 6. STOP PRINTING 10. CHANGE PRIORITY 
3. CHANGE OPTIONS 7. RESUME PRINTING 11. SP-STATUS 
4, CHANGE #0F COPIES 8, EDIT PRINT JOB 99. EXIT 

664 PAGE x OF y PAGES 

665 THE QUEUE IS EMPTY 

666 ILLEGAL NUMBER: n 

667 WRONG PASSWORD FOR PRINT JOB # n 
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668 
669 
671 
672 
673 
674 


675 


676 
677 
678 
680 
681 
682 
683 
685 
686 
687 
688 
689 
690 
691 
692 
693 
694 
695 
696 
697 
698 
699 


700 
701 
702 


703 
704 
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JOB NOT QUEUED FOR OUTPUT 
PRINT JOB # n DOES NOT EXIST 
PRINT JOB # n ALREADY PRINTING 
COPY RANGE IS 1-10 
INVALID OPTION: option 
THE DEVICE YOU WANTED IS CURRENTLY ASSIGNED TO AN ACTIVE FORM 
QUEUE, PLEASE SUSPEND THAT FORM QUEUE AND THEN CHANGE THE DEVICE 
ASSIGNMENT, 
FORM QUEUE ASSIGNMENT 
QUEUE _ FORM DEVICE DEVICE DEVICE NUMBER’ PAGE 
NAME TYPE ASSIGNED TYPE STATUS ENTRIES SKIP 


PRINT JOB SELECTED IS NOT A HOLD FILE 
STRINGS? 
OCCURANCE MUST BE NUMERIC 
SYNTAX ERROR 
INVALID SPOOL TAPE FORMAT 
THE FORM-QUEUE CANNOT BE FOUND 
PRINT JOB CANNOT BE OPENED ACCOUNT NAME AND PASSWORD TOO LONG 
PRINT JOB TABLE FULL 
PRINT JOB FULL 
A DEVICE HAS NOT BEEN ASSIGNED TO THIS QUEUE 
INCOMPATIBLE OPTIONS: NI, NH, N COPIES, I COPIES, OR N PORT 
ACCOUNT NAME CANNOT BE FOUND 
QUEUE TS ALREADY ASSIGNED TO THIS DEVICE. OK TO CHANGE? 
THE LIST OF PORTS WITH NO DEVICES ASSIGNED IS FULL 
INVALID DEVICE TYPE 
INVALID DEVICE# RANGE 
FORM QUEUE ALREADY EXISTS 
FORM QUEUE ACTIVE. ITS ASSIGNMENT CANNOT BE CHANGED 
NAME TOO LONG 
PRINT JOB# n REQUIRES A PASSWORD 
PRINT JOB# n IS NOT CLOSED 
ACTION CODES 
1. CREATE FORM QUEUE 4, CHANGE DEVICE ASSIGNMENT 7. DELETE FORM 


QUEUE 
2, CHANGE FORM QUEUE 5. CHANGE PAGE SKIP 8. PAGE EJECT 
3. CHANGE FORM TYPE 6. LIST PRINT JOBS 99. EXIT 


INVALID G-CORRELATIVE DEFINITION: definition 

INVALID FUNCTION CORRELATIVE DEFINITION: function-definition 
OF MEMORY 

ABS FRAMES 

ACTIVE LINES 

IS THE LINE TO WHICH THE SPOOLER IS ASSIGNED 

IS THE FRAME ID OF THE PCB FOR LINE ZERO 

IS THE FRAME ID OF THE BASE OF THE SYSTEM DICTIONARY 
IS THE MAXIMUM FRAME ID FOR THIS SYSTEM 

DISC DRIVE CONFIGURATION: 

DEVICE UNIT DENSITY PLATTERS 


INVALID C~CONVERSION/CORRELATIVE DEFINITION: definition 
INVALID P-CONVERSION DEFINITION: definition 
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705 
706 
707 
708 
709 


710 
T12 
715 
716 
T17 
718 
719 
720 
721 
722 
723 
736 
137 


738 
139 
740 
7441 


Th2 
780 
784 
782 
783 
800 
801 
802 
803 
805 
860 
888 
910 
911 
912 
913 
914 
915 
916 
917 
918 
919 
920 
949 
950 


951 


SYSTEM ERROR MESSAGES 


ILLEGAL CONVERSION CODE: conversion-code 

THE TRANSLATE CONVERSION CODE: 'code' IS ILLEGAL. 

DL/ID ENTRY FOR T-CONVERSION: conversion=code NOT FOUND. 
titem-id' CANNOT BE CONVERTED. 

CONFLICT IN T-CONV DEFINITION; REQUESTS VERIFY BUT THERE IS A 
NULL AMC 

INVALID Le OR Re CONVERSION DEFINITION: definiton 

VALUE TEST IMPOSSIBLE ON ATTRIBUTE WITH F~CONVERSION: definiton 
NON-NUMERIC DIGIT WITHIN PARENTHESIS ;: ‘n! 

MISSING LEFT PARENTHESIS: tn! 

‘pt IS MISSING IN PICTURE CLAUSE :'n!' 

ILLEGAL CHARACTER FOUND ON PICTURE CLAUSE: 'n! 

LITERAL EXCEEDS MAX, OF 20: ‘nt 

MISSING RIGHT PARENTHESIS: 'N! 

MISSING ' IN CURRENCY SYMBOL: ‘n't 

MISSING * IN LITERAL SYMBOL: 'n! 

MAX, LENGTH DEFINED IN DICTIONARY IS TOO SMALL FOR MF CONVERSION 
NO SCALING WITH NON-NUMERIC DATA: PAGE DATA PAGE DATA PAGE DATA 
TRUNCATION ERROR FOUND IN STORED DATA: PAGE DATA PAGE DATA PAGE 
DATA 

NON-ALPHABETIC CHARACTER FOUND: PAGE DATA PAGE DATA PAGE DATA 
NON-NUMERIC CHARACTER FOUND: PAGE DATA PAGE DATA PAGE 

SPECIAL CHARACTER FOUND IN DATA: PAGE DATA PAGE DATA PAGE DATA 
INSUFFICIENT DATA TO MATCH PICTURE CLAUSE: PAGE DATA PAGE DATA 
PAGE DATA 

NON-KATAKANA CHARACTERS FOUND: PAGE DATA PAGE DATA PAGE DATA 
titem-id' NOT ON FILE 

titem-id' ADDED 

'item-id!' UPDATED 

'item-id'! DELETED 

n ITEMS DUMPED 

> 

n ITEMS DUMPED, 

n ITEMS LOADED 

n ITEMS COPIED 

CHECK CODE ERROR 

INVALID DATE 

#T# PROCESS STOP. 

#T# PROCESS HAS BEEN LOGGED OFF BY PH=KILL 

#T® PROCESS ABORT DUE TO TIPH PROCESSING ERROR 

#E# INPUT ERROR 

#E£# PROCESS IN DEBUGGER, 

ERROR FOUND IN SUSPENDING LINE 

ERROR FOUND IN RESUMING LINE 

ERROR FOUND IN KILLING LINE 

WRONG- INPUT 

SYS2 ERROR 

LINE # MISSING 

ILLEGAL FRAME=ID IN PRIMARY SPACE! PROGRAM TERMINATED. 
LINKFIELD ERROR - GROUP AT n FRAME n 

LINKS nnnn 

ILLEGAL FORWARD LINK. GROUP AT n FRAME n 

LINKS nnnn 
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952 
953 


954 
987 
990 
991 
992 
999 
1004 
1006 
1010 


1011 
1012 
1013 


1014 
1021 


1025 
1100 


1104 


1102 
1144 
1112 
1113 
1114 
1115 


SYSTEM ERROR MESSAGES 


ILLEGAL BACKWARD LINK. GROUP AT n FRAME n 

LINKS nnno»n 

SHOULD LINK BACK TO: GROUP AT n FRAME n 

LINKS nnnn 

n NEW ERROR ITEMS CREATED IN DICT TSYM 

x XXX XXX 

INVALID ABSDUMP SPECIFICATION 

MM/DICT ENTRY MISSING, OR REQUIRED SPECIFICATION(S) MISSING, 

n ITEM(S) HAVE BEEN RESTORED 

INSUFFICIENT CONTIGUOUS BLOCKS 

ITEM titem-id' IS NOT ON FILE 

ITEM titem-id' EXISTS ON FILE 

THE PARAMETERS BEING CHANGED ARE NOT COMPATIBLE WITH THE PORT 
OPTION, 

BAUD RATE AND PCI TRANCMISSION CHARACTERISTICS CANNOT BE MODIFIED 
WITH THE SET-TERM VERB. USE "TERM" INSTEAD, 

THE PCI TRANSMISSION CHARACTERISTICS CANNOT BE CHANGED WITHOUT 
ALSO DEFINING THE BAUD RATE, 

PORT ZERO'S BAUD RATE OR PCI TRANSMISSION CHARACTERISTICS CANNOT 
BE MODIFIED WITH THE TERM VERB. USE THE DMP INSTEAD. 

ENFORCED WRITE FREQUENCY IS 1 WRITE PER n ACTIVATIONS 

DEVICE(S) TAPE ‘unit list' NOW ASSIGNED, 

RECORD SIZE = ‘n't 

DEVICE TAPE ‘unit #' IS ASSIGNED TO LINE 'line #! 

XxXxxxxK OF MEMORY 

XXXX ABS FRAMES 


XXX ACTIVE LINES 

XXX IS THE LINE TO WHICH THE SPOOLER IS ASSIGNED 

XXX IS THE FRAME ID OF THE PCB FOR LINE ZERO 

XXX IS THE FRAME ID OF THE BASE OF THE SYSTEM DICTIONARY 
XXX IS THE MAXIMUM FRAME ID FOR THIS SYSTEM 


DISC DRIVE CONFIGURATION: 
DEVICE ADDRESSES 


DISK ADDRESS FOR FRAME NO, 
DEVICE ADDRESS ; 

HEAD NO : 

CYLINDER ; 

SECTOR : 


ERROR IN WRITE INSTRUCTION TEST NUMBER 
MISSING OR ILLEGAL CHANNEL NAME 
ILLEGAL ASSIGN STATEMENT FORMAT 
ILLEGAL UNIT SPECIFICATION 

MISSING OR ILLEGAL RECORD SIZE 
EXTRANEOUS INPUT AT END OF STRING 
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1116 DUPLICATE ENTRIES IN UNITLIST 
1119 DEVICE TAPE ‘unit #'! IS ASSIGNED TO THIS LINE, BUT FOR ANOTHER 
CHANNEL. 
1120 DEVICE(S) TAPE 'unit list' NOW ASSIGNED TO CHANNEL ‘channel name! 
1121 ILLEGAL CHANNEL SPECIFICATION. 
1122 TAPE UNIT NUMBER MUST BE SPECIFIED. 
1123 ILLEGAL RECORD SIZE, 
1124 DEVICE TAPE 'tunit #' NOT ON THIS SYSTEM 
1125 UNIT NOT ASSIGNED 
1127 SEQUEL 
n SYSTEM SERIAL NUMBER 
nk OF MEMORY 
n IS MAXIMUM FRAME-ID 
n PORTS 
n IS FIRMWARE TYPE 
n IS FIRMWARE VERSION NUMBER 


WORDMATE 
AVAILABLE DEVICES 
DEVICE UNIT(S) 


1129 NO SUCH TAPE ASSIGNMENT EXISTS, 

1193 UNRESOLVED TAPE SYSTEM ERROR 

2001 MISMATCHES IN INTERMEDIATE OBJECT CODE. 
2002 ABORT, RE~EXECUTE TCL-II VERB 'STOREPF! 
2321 ITEM 'item-id' ERROR 

9009 PQ-SELECT REGISTER OUT OF RANGE 1-5 
9012 UPDATE ATTEMPTED ON AN INPUT FILE AT STATEMENT: statement 
9020 COMPILATION ABORTED, 

9021 PROC FORMAT ERROR IN LABEL 

9022 DUPLICATE LABEL FOUND. 

9025 FORMAT ERROR IN 'GO! STATEMENT 
LOGON L 
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A/AMC 


10 


Ll 


12 
13 
14 
15 


16 
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STAT-FILE DICTIONARY 


Name 


ORDER. 


ACUCOUNTNAME. 


FLLENAME. 


FILE. 


LEVEL. 


BASE. 
MOD. 
SEP. 
ITEMS. 
SIZE. 
MAX-T 
MIN-I 


AM/GP 


MN/GP 


FRAMES. 


25% 


50% 


75% 


100% 


Sequence in which file was encountered during the 
file-save 


First segment of Attribute 1 (G*1). Specifies the 
account the file resides in 


Second segment of Attribute 1 (G1*1). The name of 
the file 


Second and third segments of Attribute 1 (G1*2). If 
the third segment of Attribute 1 is present, this 
specifies the data section of the file named in 
second segment. 


System level of the specified file 
O = System Dictionary 

Master Dictionary 

Data dictionary 

Data file 


ewer 
to ou 


Beginning frame number of the file 

Modulo of the file 

Separation (number of frames per group) of the file 
Total number of items in the file 

Size of the file in bytes (characters) 

Size (in bytes) of the largest item in the file 
Size (in bytes) of the smallest item in the file 


Maximum number of items found in any group in the 
file 


Minimum number of items found in any group in the 
file 


Total frames, including linked, used by the file 
Number of groups that are 25% full or less 
Number of groups that are 25% to 504 full 
Number of groups that are 50% to 75% full 


Number of groups that are 75% to 100% full 


APPENDIX C. STAT-FILE DICTIONARY (Continued) 


A/ AMC Name Definition 
17 125% Primary space of groups in this category is full and 


25% additional linked space is required 


13 150% Primary space of groups in this category is full and 
90% additional linked space is required 


19 200% Primary space of groups in this category is full and 
additional linked space equals the primary space 


2U >20U% Primary space of groups in this category is full and 
additional linked space is greater than the primary 
Space. 

21 GFE Group format errors, if any, in the file 

99 SECONDARY. Computes the number of Linked frames required for the 


file by multiplying modulo times separation and 
subtacting the product from the total frames 
CF3534;*3125;-) 


99 AVG. SIZE Computes the average item size by dividing the size 
by the total items in the file (F;6;7;/) 


DL/ID DL/ID of STAT~FILE. Note that Attribute 1 is DY, 
not Db. 
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APPENDIX D. CREATING THE PH~HISTORY FILE. 


The Terminal Independent Process Handler (TIPH) uses the PH-HISTORY file to 
indicate the status of the TIPH processes. If the file does not exist, you may 


create it by using the CREATE-FILE verb, adding the necessary attribute 
definition items using the EDITOR. 


fo create the PH-HISTORY file, perform the following: 

1. Create the file on the SYSPROG account using the CREATE-FILE verb. The 
modulo and separation of the dictionary section should both be "1". The 
modulo of the data section should be "37", the separation should be “1". 

2. Use the EDITOR to enter the attribute values shown in Figure A to create 
the attribute definition items in the dictionary portion of the PH-HISTORY 
file. 


3. Use the EDITOR to change the file”s D-pointer in SYSPROG’s M/DICT to an 
“E’. 


4. Copy the E-pointer to the SYSTEM file. 
5. Use the EDITUR to change the E-pointer back into a D-pointer. 


6. Place a Q-pointer to PH-HISTURY in the M/DICT of each account which 
requires access to it. 


Figure B shows an example of the creation procedure. 


Attribute ACCOUNT DATE LINE OP OUTFL# STARTER-ACC STATUS TASK-ID TIME 


D/CODE 
A/ AMC 


V/TYPE 


a 
1 
* 
* 
* 
* 
* 
* 
fi 
V/MAX 1 


Noe Fe EH EO 
tO & FFF OF HN D 
Wr OM + & FF FOOD 
KO eX FF HF FH D 
NW + * Fe * FO D 
all a ee ee 


A 
2 
* 
x 
* 
* 
D 
x 
L 
1 


* null 


Figure A. Attribute Definition Item Information for PH-HISTORY 
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[417] FILE “PH-HISTORY” CREATED; BASE = xxxxx, MODULO = 1, SEPAR = 1 
[417] FILE “DL/1D*“ CREATED; BASE = xxxxx, MODULO = 37, SEPAR = 1 


“ACCOUNT” FILED. 


Use the EDITOR to enter the other attribute definition items in a similar 
fashion. 


1 ITEM COPIED. 


~——- (while logged onto the user's account) 


“PH-HISTORY” FILED. 


The format of the Q-pointer to the PH-HISTORY file is shown in Figure B of 
the topic TIPH INITIALIZATION MESSAGES. 


Figure B. Creating the PH-HISTORY File 
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APPENDIX HK. SAFEGUARDING SAVE TAPES 


Tape errors way result from the effects of numerous sources. Tape transport 
and controller hardware defects and misalignments are the cause of many tape 
errors. A reliable save should not be expected from a faulty medium. On _ the 
tape transport, the tension bars must be properly adjusted to prevent tape 
cinching and edge damage. Head misalignment, signal level improperly set, and 
excessive wear from overuse of the same tape can all contribute to 
unrecoverable tape errors. 


However, the more cowmon source of tape errors is not mechanically induced by 
faulty equipment; instead, it is the result of careless handling of the tape 
during its use or its improper care while in storage. If the data to be saved 
is properly written to tape, the data cannot be expected to remain intact if 
the tape is left: 1) lying around the computer room, out of its case, near 
electromagnetic field and dust-generating equipment, 2) around eating and 
smoking people, 3) underneath stacks of listings, or 4) next to an open window 
on a windy, hot day. 


The tape should be stored inside its case in a vertical position, in an 
environment whose temperature is within 5 degrees C of 24 degrees C, whose 
humidity is within 10% of 1U RH, and will be exposed to an electromagnetic 
field of less than 50 oersteds. 


When the tape is used during a save or restore, care should be taken to ensure 
that the tape reel is handled in a manner which will not cause it to get dirty. 
The tape“s case should be closed when the reel is not inside so that the tape 
is not exposed to dust. The reel should be held with the thumb inside the hub, 
not by the flanges, to prevent excessive pressure on the sensitive edges of the 
tape. When mounting the reel onto the tape transport, exert equal pressure all 
around the hub to ensure the reel is mounted flush to prevent edge damage. 


It is necessary to emphasize that correct handling and storage of the magnetic 
tape is an integral part of any Save/Restore program. 


For more information on care and maintenance of magnetic tapes, refer to the 
following manuals: 


1) Computer Tape Care and Handling, Memorex Corp., 1979. 


2) Magnetic Tape Management, Computer-Link Corp., 1981. 
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A 
A option 
MT-VERIFY 194 
MVERIFY 294 
SAVE 288 
SEL-RESTORE 257 
TIMESLICE 226 
VERI FY-SYSTEM 294 
WHERE 222 
A status code (TIPH) 324 
A/ AMC 36 
ABS 
area for user Assembly code 12 
load 62,258 
restore 62,258 
section (on tape) 52 
ABS/FILES verb 258 
ABSLOAD verb 62 
ACC file 40,100,102,104 
logging statistics 92 
ACCOUNT file 92,100,102 
ACCOUNT~FILE~STATS PROC 302 
ACCOUNT-RESTORE verb 254 
ACCOUNT-SAVE PROC 252 
ACLC self test 47 
ACTIVE status 128 
ADDD verb 201 
ADDX verb 201 
AF restore 52,54 
ALL=-FILE-STATS PROC 302 
AMC 36 
ASCII equivalents A= 4 
ASSIGNED status 128 
Aborting a TIPH process 322 
Account, save procedure 253 
Account-restores 254 
Accounting 
data, listing of 240 
history 40,100,102, 104 
Accounts 92 
creation of 290 
deletion of 292 
Active user items 100,102 
Additional work 
space 14,60,90,92,94 


Addresses (disc) of frames 300 
Alignment command 168 
Allocating a TIPH line 316 
Arithmetic commands 200 


I-14 


INDEX 


Assembly language, set-up 
Assigning a port 
Attachment of 
devices 
tape unit 
Attribute 
definition item 
definition item, list 
definition of 
mark count 
mark 
Automatic spooler start 
Available 
lines,determination of 
space 


B 


B-segment (file-save tape) 

BASIC, enabling user account 

BINARY=SAVE PROC 

BLOCK=CONVERT file 

BLOCK=PRINT verb 

BLOCK-TERM verb 

BS/R tape format 

BUFFERS verb 

Backing-up files 

Backspace 

Backward position command 

Base of SYSTEM Dictionary 

Base, definition of 

Binary 
Save/Restore 
dise restore 
disc-to-tape 
tape-to-dise 

Bit 

Block printing 

Bootload option 

Bootstrap 
section (on tape) 
tape, creation of 

Bringing up the system 

Buffer status 

Byte 
statistics 


(overview) 


transfer 
transfer 
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290 
316 


118 
178 
20 

36 ,38 
240 
18 

36 

20 
180 


316 
16,228 


264,266 
291 
270,274 
208 

208 

208 

270 

306 

262 

73 

166 

56 

18 


270 

278 
270,274 
270,278 
18 

208 
48,49 


52 
288 
52,54 
306 
18 
230 
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C 


CABLE OFF status 
CHANNEL file 
CHARGE-TO verb 
CHARGES verb 
CHECK PROC 
CHECK-SUM command 
CHOO-CHOO PROC 
CLAIM verb 
CLEAR=BASIC-LOCKS verb 
CLEAR-FILE processor 
CLEAR~FILE verb 
COLDDUMP verb 
COMPARE PROC 
COPY Verb 
options for 
CP PROC 
CPU 
firmware tests 
milliseconds, display of 
CREATE=ACCOUNT PROC 
CREATE=FILE 
processor 
verb 
CT PROC 
Cancel-line control character 
Change 
#of Copies action code 
Baud Rate option 
Form Queue action code 
Form Type action code 
Options action code 
Page Skip action code 
Priority action code 
Changing 
a form queue name 
accounts 
device assignments 
job options 
number of copies 
print job priority 
printer forms 
Character 
count field 
set 
Checking for parity errors 
Checksum errors (ABS load) 
Clearing 
ACC file 
execution locks 
files 
group locks 
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128 
100 
88 
88 
242 
230 
240 
16,228 
310 
106 
112 
288 
242 
114 
116 
240 


46 
222 
290 


106 
108 
240 

73 


152 

50 
134 
136 
150 
142 
170 


134 

90 
138 
150 
152 
170 
136 


20 
A-1 
188 

63 


104 
310 
112 
310 


Code compaction 234 
Coldstart 

section (on tape) 52 

tape, creation of 288 
Coldstarts 60 
Column headings 36 
Command stream (TIPH) 318 
Compacting source code 234 
Comparing files 242 
Complete restore (overview) 52,54 
Computer usage 

statistics 88,100,102 
Configuration, display of 219,224 
Connectives, listing of 240 
Contiguous available space 16,228 


Continuation of line character 73 
Control 


characters 73 

panel ho 
Conventions 7 
Conversions 

decimal to hex 200 

hex to decimal 200 
Copies option 122 
Copying 

files 114 

items to a file 114 

items to the terminal 240 

object code to tape 312 
Corelocking frames 309 
Create Form Queue action code 132 
Creating 

SYS-GEN tapes 294 

a PH-HISTORY file D—1 

a coldstart tape 288 

file statistics 302 

files while copying 116 

files 108 

user accounts 290 
D 
D option 

copy 116 

save 289 
D-segment (file-save tape) 262,264 
D/ CODE 32, 34,36 
DATA/BASIC 

enabling user account 291 

processor 4 
DATE=FORMAT verb 220 
DE=-COPY verb 298 
DE=RESET verb 299 
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DE-START verb 299 
DELETE PROC 236 
DELETE-ACCOUNT PROC 292 
DELETE-FILE processor 106 
DELETE-FILE verb 112 
DISCIO verb 224 
DIVD verb 200 
DIVX verb 200 
DL/ID item 32,33,708 
DMP 42 
Bootload option 49.4 
Change Baud Rate option 50 
Display/Alter Memory option 51 
Enter Firmware Debugger option 50 
Reset System option 48 
Resume CPU Processing option 50 
Run CPU Firmware Diag. option 51 
Run DMP Firmware Diag. option 51 
Self tests 47 
Stop CPU option 50 
Switch Control option 50 
DSKAD verb 300 
DTX verb 201 
DUMP verb 212 
Data file 10 
Data structures 12 
Date 
setting of 220 
Deactivating a TIPH process 322 
Deallocating a TIPH line 316 
Debug 
commands 81 
facility 80 
Decimal 
equivalents Am 
to hex conversion 200 
Delete 
Form Queue action code 140 
Job action code 154 
Deleting 
TIPH lines 316 
a form queue 140 
accounts 292 
files 112 
items 236 
print job options 150 
print jobs 154 
Detachment of tape unit 178 
Determination of memory content 306 
Determining 
available lines 316 
buffer status 306 
if data has changed 230 


1-3 


Device 
attachment 90,118 
numbers of spooler 132 
Diagnostic Maintenance Processor 42 
Dictionary 30 
items (summary) 38 
level file 10 
levels 30 
Dise 
Self Test 48 
activity report 224 
addresses 300 
error recording 298 
mapping 300 
reads, displaying number of 222 
space assignment (restore) 56 
Space layout 12,14 
Display/Alter Memory option 51 
Displaying 
PH-HISTORY file 324 
TIPH lines 316 
TIPH status 324 
group locks 310 
items 114 
user assignments 222 
Documentation, SEQUEL 6 
Dumping 
frames 212 
group data 212 
items 210 
link fields 212 
to tape 190 
Duplicating items 114 
E 
E option 
COLDDUMP 289 
MT-VERIFY 194 
MVERIFY 294 
VERI FY-~SYSTEM 294 
EBASIC verb 234 
ECOPY verb 234 
EDITOR processor 5 
EEDIT verb 234 
END command (debugger) 81 
ENGLISH 
attribute definition item 36 
processor 4 
ERRMSG 
file 40,84, B-1 
item formats 84 
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Echo-plex T2 


Edit Print Job action code 162 
Edit Print Job Commands 164,166,168 
Ejecting printer pages 142 
Enabling 

user account for Assembly 290 


user account for DATA/BASIC 290 
Error 


display (BS/R) 280 
mesages (TIPH) 326 
messages, system B-1 
recovery (BS/R) 280 
recovery during file loads 68 
recording of disc 298 
European date format 220 
Executable area 12 
Execution locks 80,310 
Exit command 168 
Expansion of source code 234 
F 
F option (SAVE) 289 
F restore 258 
F/ BASE 32 
F/ MOD 32 
F/REALLOC 33 
F/ SEP 32 
FID 12 
information 214 
maximum 56 
FILE-SAVE PROC 262 
FINISH print job status 144 
FIX-FILE-ERRORS verb 232 
FLIP PROC : 242 
File 10 
area 12,14 
backup 262 
clearing of 112 
comparison aye 
creation of 108 
creation of while copying 116 
definition items 32,38 
definition of 18 
deletion of 112 
hashing histogram 216 
hierarcy 30 
levels 30 
loads, error recovery 68 
management PROCs 236 
management processors 106 
organization 10 
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overview 30 
reallocation 33 
restoring individual 256 
security 32,98 
statistics report 302 
structure 18,30 
synonym definition items 34,236 
updating 26 
File-restore 52,54 
initiation 52,54,258 
sequence of events 66 
File-save 
tape segments 266 
tape, format of 264 
tape, sections of 53 
SAVE verb 288 
Files 
comparing two 2he2 
listing of 240 
overview 30 
section (on tape) 52 
Form queue 
ereation of 132 
deleting a 140 
definition of 118 
Form-type, definition of 136 
Format 
error (ABS load) 63 
of file save tapes 264 
of system date 220 
of verb definition items TH 75 
Formated file-save 262 
operation 268 
Forward position command 166 
Frame 12 
address on disc 300 
dumping of 212 
linkage 24 
locking in memory 308 
unlocking from memory 308 
Free space 14,228 
Full-duplex T2 
G 
G command (debugger) 81 
G option (dump) 212 
GROUP verb 214 
Games 242 
General system messages 86 
Generating 
SYS-GEN tapes 294 
I-4 


checksums 
Group 
definition of 
dumping of 
format errors 
format errors during save 
information 
locks 
locks during file-save 
terminators 


H 


H command (debugger) 
H option 
HASH=TEST 
ISTAT 
TIPH 
HASH-TEST verb 
HS work space area 
Halting a TIPH process 
Hashing information 
Hashing 
Heading, column 
Hex to decimal conversion 
Hexadecimal equivalents 
Hold files 
assignment of 
definition of 
Hush option (TIPH) 


I 


I option (COPY) 

I option (DATE-=FORMAT) 

I option (SAVE) 

I option (T-DUMP) 

I spooler option 

I-segment (file-save tape) 
I/O controller self tests 
IS work space area 

ISTAT verb 

ITEM verb 

Incompatible spooler options 
Initializing the system 
Initiating a TIPH process 
Initation of file-restores 
Input buffer size limit 
Input statement parsing 
Input statement 

Instant output option 


T-5 


123 


264, 266 


46 
94 
216 


International date format 220 
Interruption of processing 80 
Intra-processor linkages 71 
Introduction 1 
Item 
count 20 
definition of 18 
deletion of 236 
dumping 210 
hashing information 214 
maximum size 18 
restoring individual 256 
structure (logical) 22 
structure (physical) 20 
update routine 28 
updating 26 
Item-id 18 
definition of 18 
maximum size 18 
Item-lists 76 
K 
K option (SAVE) 289 
K status code (TIPH) 324 
L 
L option (COPY) 116 
L option (DUMP) 212 
L/ RET 32,98 
L/ UPD 32,98 
LIMITS verb 224 
LIST~DISC=ERRORS PROC 298 
LIST-FILE=STATS PROC 302 
LIST-LOCKS verb 310 
LISTACC PROC 240 
LISTCONN PROC 240 
LISTDICTS PROC 240 
LISTFILES PROC 240 
LISTPF PROC a4) 
LISTPROCS PROC 244 
LISTU PROC 241 
LISTVERBS PROC eu 
LOCK=FRAME verb 308 
LOGTO verb 90 
LP106 PROC 244 
LP136 PROC 244 
LP80 PROC 244 
Labels, reading of 196 
Line 
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continuation character 73 
202,204,206,241 


printer traits 
Line~at-a-time mode 


118 


Line-feed command (debugger) 81 
Link field format for frames 213 


Linked available space 16,228 
List 
Print Jobs action code 144 
command 164 
Listing 
POINTER-~FILE 244 
PROCs 244 
accounting data 240 
attr. definition items 240 
connectives 240 
existing files 240 
logged on users 244 
verbs 241 
Loading 
a new account from tape 254 
assembly code from tape 194 
Locate command 164 
Lock codes 92 
Locking frame in memory 308 
Logged on users, listing of 2u4 
Logging off 82,83 
Logging on 82 
Logon 82 
PROC 86,90 
message 84 ,86 
processor 82 
Low dise space 14,56 
M 
M option (T-CHK) 188 
M/DICT 10,30 
items 38 
MEM-DIAG verb 296 
MESSAGE verb 218 
MSG verb 218 
MT~LOAD verb 194 
MT~VERIFY verb 194,312 
MULD verb 200 
MULX verb 200 
Mag tape self test 49 
Magnetic tape 
I/0 190,192,194 
control 188,242 
detachment 188 
file-save format 264 
parity errors 242 
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units 182 


Making SYS-GEN tapes 294 
Manual usage 6 
Manuals for SEQUEL 6 
Master dictionary 10 
items 38 
Maximum 
FID, calculation of 56 
item size 18 
Memory 
buffer status 306 
contents, determination of 306 
diagnostic 296 
testing 296 


Message formats (error messages) 84 
Messages (at logon time) 


Modulo 108 
and separation, selection 110 
definition of 18 
testing different 216 

Monitor 9,12 

Multiline column headings 36 

Multireel tape operations 196 

Multivalue 20 

N 

N option 73 
AF Restore 54 
BUFFERS 306 
COPY 116 
DUMP 212 
GROUP 214 
HASH-TEST 216 
I-DUMP 210 
ISTAT 216 
ITEM 214 
SEL=RESTORE 257 
T=-DUMP 190 
T=READ 190 
TIPH 320 
WHERE 222 
Misc. PROCs 244 

N spooler option 123 

NEED DEV status 128 

NEWAC file 40 

NEXT REEL status 128 

NNCF 25,213 

NO DEVICE status 128 

NOHUSH verb 72 

NOT READY status 128 

NPCF 25,213 

I-6 


No logging option (TIPH) 320 


No spooling option 123 
6) 
0 option 
COPY 116 
SEL-RESTORE 257 
T-LOAD 192 
O-segment (file-save tape) 264 
orf 
command (debugger) 81 
verb 82 ,83 
OPEN print job status 144 
OPTIONS message 52 
OS work space area 94 
OTHER OPTIONS message 54,55 ,63 
OUTFL (TIPH) 324 
OUTPUT 
devices 118 
Object code, verification of 294 
Operation of formatted file-save268 
Option format 73 
Options for COPY processor 116 
Overflow 
file space 110 
frames, release of 1142 
Space, use during save 289 
space 16 
P 
P command (debugger) 81 
P option 73 
BUFFERS 306 
CHECK-SUM 230 
COPY 116 
DISCIO 224 
DUMP 212 
GROUP 214 
HASH=TEST 216 
I~DUMP 210 
ISTAT 216 
ITEM 214 
LIMITS 224 
MT-VERIFY 194 
MVERIFY 294 
POVF 228 
T~DUMP 191.1 
T-LOAD 192 
T-READ 190 
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TIPH 320 
VERIFY-SYSTEM 294 
Mise. PROCs 241 
P-ATT verb 176 
P-DET verb 176 
PARITY status 128 
PCB FID, display of 222 
PCB 12 
PH-ALLOCATE verb 316 
PH-DELETE verb 316 
PH-HISTORY file 315 
attr def items D~1 
creation of D=1 
PH-KILL verb 322 
PH-LINES verb 316 
PH-RESUME verb 322 
PH-START verb 318 
PH-STATUS verb 324 
PH=-SUSPEND verb 322 
PIB status byte one 222 
POINTER-FILE 33,266 
listing 241 
POVF verb 16,228 
PRINT print job status 144 
PRISM character codes A=1 
PROC processor 5 
PROCLIB file 40 
PROCs, listing of 241 
Page Eject action code iho 
Paging, virtual memory 
Parity errors 188,242 
ABS load 62 
during file loads 68 
Parsing Te 
Password 82,92 
Periodic clearing of ACC file 104 
Positioning tape 188,242 
Power up 45 46 
Primary 
control block 12 
entry point 75 
file space 24,110 
Print 
on/off 81 
option (TIPH) 320 
Print command 168 
Print job 
assignment of 122 
changing copies of 152 
definition of 118 
deletion of 154 
examination of 162 
interruption of 160 
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kill printing of 160 
priority of 170 
status 144 
suspend printing of 160 
Printer 
attachment of 176 
characs. 202,204,206,241 
detachment of 176 
items 114 
restarting of 158 
Priority of processes 226 
Privilege level 90,92 ,93 
display of 224 
Process 
activations, display of 222 
deactivation 322 
definition of 12,314 
handler 314 
priorities 226 
reactivation 322 
suspension 322 
timeslices 226 
work space assignment 56,90 
work space amount 224 
work space 12,14,92,94 
Processor entry point 15 
Processors 71 
overview 4 
Program interruption 80 
Q 
Q pointers 34,236 
Q-segment (file-save tape) 264,266 
Quantum 226 
R 
R Option, AF Restore 54 
REMT button 42 
RESET~DISC-ERRORS PROC 299 
RESTART=SPOOLER verb 180 
RUNOFF processor 5 
Reactivating a TIPH process 322 
Reading tape labels 196 
Reading tapes 190 
Reallocation of files 33 
Redisplay line control character 73 
Releasing a TIPH line 316 
Reloading system 
files 52 ,54,258 
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software 62,258 
Reserved space 12 
Reset System option 50 
Resetting 

execution locks 310 

group locks 310 
Restarting 

the printer 158 

the spooler 60,62 
Restore 

accounts 254 

from Binary Save/Restore 278 

individual file 256 

individual item 256 

initiation of 52 ,54,258 

sequence of events 66 
Resume CPU Processing option 50 
Resume Printing action code 158 
Retrieval protection 98 
Return stack, display of 222 
Run 

CPU Firmware Diag. option 51 

DMP Firmware Diag. option 51 

BUFFERS 306 

COPY 116 

GROUP 214 

ITEM 214 

SAVE 289 

T~CHK 188 

T=LOAD 192 

WHERE 222 
Ss 
S spooler option 123 
S status code (TIPH) 324 
S-DUMP verb 210 
SAVE verb 288 
SEL~RESTORE verb 256 
SEQUEL 

control panel 42 

file organization 10 

self tests 2 
SET~ALLOCATION program 33,110 
SET-DATE verb 220 
SET-FILE PROC 236 
SET-TERM verb 204 
SET=-TIME verb 220 
SET-WRITES verb 246 
SETUP=ASSY PROC 290 
SHUTDOWN 286 
SLEEP verb 222 
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SP={ASSIGN verb, format of 
SP-COPIES verb 
SP-CREATE verb 
SP-DELETE verb 
SP-DEVICE verb 
SP-EDIT commands 
SP-EDIT verb 
SP~EJECT verb 
SP=-FORM verb 
SP-JOBS action codes 
SP-JOBS verb 
SP-KILL verb 
SP=MOVEQ verb 
SP-NEWTAB verb 
SP-OPTS verb 
SP=-PORTOFF verb 
SP-PORTON PROC 
SP-RESUME verb 
SP=-SKIP verb 
SP=STATUS verb 
SP-STOP verb 
SP=SUSPEND verb 
SP-SWITCH verb 
SP=TAPEOUT verb 
SP-TYPE verb 
SPACE PROC 
ST=DUMP verb 
STANDARD form queue 
STAT=FILE 

dictionary 
STOP status 
SUBD verb 
SUBX verb 
SUSPEND status 
SYNONYM NOT FOUND message 
SYS-GEN PROC 
SYS-UPDATE PROC 
SY SPROG 

PROCs 

account 

verbs 
SYSPROG-PL file 
SY STEM 

dictionary 

dictionary items 
SYSTEM-OBJECT file 
SY STEM-SETUP PROC 
Safeguarding Save Tapes 
Saving 

files 

individual accounts 
Screen-oriented verbs 
Secondary file space 
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122,124 
152 
132 
154 
138 


162,166,168 


162 
142 
134 
144 
144 
160 
146 
180 
150,170 
172 
172 
158 
142 
128 
156 
160 
148 
178 
136 
242 
190 
120 
302,304 
304,C-1 
128 


312 
54 60,260 
E-1 


262 
252 
120 
110 


release of 112 
Secondary values 20 
Security 32,92,98 

code comparison 99 

codes 98 


Segments on file-save tapes 265,266 
Selecting modulo and separation 110 


Selective restores 256 
Sending messages to other users 218 
Separation 108 
definition of 18 
Setting 
a process to "sleep" 222 
date format 220 
printer traits 202,204,206 
process priorities 226 
system time and date 220 
terminal traits 202,204,206 
up user accounts 290 
Single level file 30 
Software 
instruction location 80 
location of users 222 
Source code 
compaction 234 
expansion 234 
Special control characters 73 
Spooler 
TCL verbs 120 
assignment 90 
device assignments 138 
device attachment 120 
options 122 
output devices 130 
overview 118 
starting of 60,62 
status 128,144 
tape control 178 
verbs 120 
Spooler devices: 
line printer 130 
port 130 
tape unit 130 
Standard files 40 
Standards 7 
Starting 
a TIPH process 318 
a file-restore 258 
the spooler 118 
Statement parsing T2 
Statistics 
computer usage 88,100,102 
of files 302 
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Status code (TIPH) 324 


Subvalue 20 
definition of 18 
mark 20 

Summary of dictionary items 38 

Suppress 
output option 123 
printing 81 


Suspend Printing action code 160 
Suspending a TIPH 


line 322 
process 322 
Switch Control option 50 
Synonym file definition item 34,236 
System 
Configuration, display 219,224 
Control Menu 4,49 ,50 
Dictionary 290 
error messages B-1 
files 40 
generation 294 
information 218,224 
initialization 260 
message formats 84 
messages 86 
privilege level, display 224 
privileges 92,93 
programmer account 224 
restore (overview) 52,54 
security 98 
upgrades, configuration of 64 
utilities 200 
verification 294 
T 
T option 
ACCOUNT=SAVE 252 
BUFFERS 306 
COPY 116 
DISCIO 224 
FILE-SAVE 262 
SAVE 289 
T=DUMP 191.1 
TIPH 320 
T status code TIPH 324 
T-ATT verb 178 
T-BCK verb 188 
T=CHK verb 188 
T-FWD verb 188 
T-LOAD verb 192 
T=PRINT PROC 178 
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T=-RDLBL verb 198 
TREAD verb 190 
T-REW verb 188 
T-WEOF verb 188 
TAPE FORMAT ERROR message 68 
TCL, overview 70 
TCL-I 
input statements 78 
verbs 78,79 
T=DET 188 
TCL=-II 
input statements 76 
parameter string 75 
TCL 70,72,74,76 
TERM verb 202,206 
TERMINAL PROC 206 
TIME verb 220 
TIMESLICE verb 226 
TIPH 
command stream 318 
initialization messages 326 
line assignment 318 
lines 316 
options 320 
overview 314 
status display 324 
task-id 318 
termination messages 328 
verbs 315 
TSYM file 232 
Tape 
1/0 190,192,194 
eontrol 188 
detachment 188 
dumping from file to tape 190 
error (Binary Save/Restore) 278 
format of file-save 262 
labels, reading of 198 
loading file from tape 192 
operations, multireel 198 
reading of 190 
segments (file-save) 263,264 
Task-id (TIPH) 318 
Terminal 
characterisites 202,204,206 
control lang., overview T0 
echo 72 
output option (TIPH) 320 
port 130 
Termination messages (TIPH) 328 
Tertiary entry point 75 
Test modulo 216 
Testing main memory 2904 
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Time, setting of 220.2 2=«W 


Timeslices 226 
Top of Print Job command 166 WAIT print job status 144 
Transferring print jobs 146 Warmstarts 58 
Types of verbs 70 WHAT verb 219 
WHERE verb 222 
WHO verb 218 
U WORKSPACE verb 96 
Work space 12,14,60 
U option assignment 56 ,90,92,94 
DUMP 212 display amount of 224 
T-DET 188 Writing tape labels 196 
UNLOCK=FRAME verb 308 
UPDATE=-ACCOUNT PROC 294 
USER verb 224 x 
Unlocking frame from memory 308 
Update X option 
protection 98 COPY 116 
routine 28 DUMP 212 
Updating T=READ 190 
items 26 X status code (TIPH) 324 
user accounts 294 X-Segment (file-save tape) 264 
Upgrades, system configuration 64 XTD verb 201 
Use of overflow 
during file-save 289 
User assembly code ABS area 12 Z 
User accounts 92 
creation of 290 Z option (BUFFERS) 306 
deletion of 292 
updating 294 
User assignments 224 
display of 222 
User frame assignments 12 
User identification items 92,98 


User manuals for SEQUEL 
Users, listing those logged on 241 


af 
VCONV 36 
V/CORR 36 
V/MAX 37 
V/TYP 32,37 
VERIFY-SYSTEM PROC 294 
VALUE MARK 20 
Verb 
definition items 74 
listing of 241 
types 70 


Verifying ABS code against tape 194 
Virtual memory 8 
structure 12 
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